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PREFACE 



MANUAL OBJECTIVES 

The information in this manual enables the new user of the RSX-llM 
operating system to create a text file, using an editing program, and to 
create and run a simple FORTRAN-IV program from that file. 

INTENDED AUDIENCE 

This manual is for the new RSX-llM user. It assumes that you have 
some computer experience, but no experience with RSX-1 IM. 

STRUCTURE OF THIS DOCUMENT 

This manual is structured so you can learn RSX-1 IM concepts and termi- 
nology as you create and run a FORTRAN-IV program called ADD.FTN. 

Chapter 1 explains how to use a terminal on the RSX-llM operating 
system. Chapter 2 discusses program preparation on RSX-llM, including 
use of an editing program, a compiler, and the Task Builder. Chapter 3 
outlines the RSX-1 IM method of handling files and records. Chapter 4 
discusses two system programs designed for handling files: PIP and the 
Queue Manager. Appendix A outhnes the steps involved in the develop- 
ment of ADD.FTN, without the extensive explanation provided in eariier 
chapters. (For more detailed information on programming under 
RSX-1 IM, see the RSX-1 IM/M-PLUS Guide to Program Development. ) 

ASSOCIATED DOCUMENTS 

This manual refers frequently to other RSX-llM documents which are 
described in the RSX-llM Documentation Directory. The directory 
defines the intended audience for the manuals in the RSX-llM set and 
provides a synopsis of each manual's contents. 

CONVENTIONS USED IN THIS MANUAL 

"print" The term "print" indicates what the computer displays 

at the user's terminal. 

"type" The term "type" indicates what the user types at the 

terminal keyboard. 

Black ink In illustrations of dialogue between the user and the 

computer, what the computer prints is shown in black 
ink. 

Red ink In illustrations of dialogue between the user and the 

computer, what the user types is shown in red ink. 
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Preface 



[ ] Square brackets enclose the optional parameters to a 

command. For example: 

>PRINT [/optional switches] 

However, the brackets are not part of the command. 
That is, if you want to use the optional COPIES 
switch with the print command above, you do not 
include the brackets in the command line. You simply 
type: 

> p R :i: N 1 / €, c) I"' :i: i;;: s ; 2 f . f i\ m 

[144,34] A UFD specification in a command line is always en- 

closed in brackets when you type it; that is, the brackets 
are required for the UFD syntax. 

RUN Uppercase characters, in lines illustrating command 

formats, indicate material that you must type exactly 
as shown. 

filename Lowercase characters, in lines illustrating command for- 

mats, indicate variable parameters that you select. 
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CHAPTER 1 
USING THE TERMINAL 



This chapter tells you how to use a terminal to communicate with the 
RSX-1 IM operating system. The operating system, in turn, communi- 
cates with the computer hardware. 

An operating system translates language you can understand into language 
the computer can understand. It also translates messages from the com- 
puter hardware to you. This two-way (interactive) communication pro- 
cess usually takes place through a terminal. 

You can use a variety of terminals with RSX-l IM. These fall into two 
general categories: hardcopy terminals that print characters on con- 
tinuous forms of paper, and Cathode Ray Tube (CRT) terminals that 
display characters on a screen. Most CRT terminals do not provide per- 
manent records of the activity on your terminal. Figure 1-1 shows an 
LA36 hardcopy terminal. Figures 1-2 and 1-3 show the VT52 and the 
VTIOO CRT terminals. 




Figure 1-1 An LA36 Terminal 
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Figure 1-2 A VT5 2 Terminal 




Figure 1-3 A VT 1 00 Terminal 
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1 . 1 USING THE TERMINAL KEYBOARD 

All terminal keyboards have the same basic layout as a typewriter. In 
addition, the keyboard includes special keys that affect various computer 
functions. These keys are not in the same position on all terminals; so 
check the keyboard layout each time you use a terminal that is new to 
you. Figure 1-4 is the keyboard of the LA36 and VT52 terminals. Figure 
1-5 illustrates the keyboard of the VTIOO terminal. 
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Figure 1-4 LA36/VT52 Terminal Keyboard 
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Figure 1-5 VTIOO Terminal Keyboard 

1.1.1 Terminal Function Keys 

Some of the function keys that appear on terminal keyboards are de- 
scribed in Table 1-1. Check the documentation for the system program 
you are using for specific information on that program's use of terminal 
function keys. 

1.1.2 Control Characters 

You can enter a control character by pressing the appropriate letter while 
you hold down the CTRL key. The system responds to some control 
characters by displaying the up arrow (') followed by the letter you 
typed ("U, for example). Some other control characters are not echoed 
on your terminal, depending on the function they perform. 

The control keys Usted below are options selected at system generation. 
Therefore, if they do not work for you as described below, check with 
your system manager to see if they are part of your system. 
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Table 1-1 Special Terminal Keys 



Function Key 


Description 


CR or RETURN 


Terminates an input line and advances the 
carriage or cursor to the first position on the 

next line. 


CTRL/n 


Part of numerous 2-key combinations (CTRL 
and a letter key. When you press the CTRL 
key, followed by the appropriate letter, the 
combinations can perform a variety of func- 
tions. Each valid combination is called a 
control character, represented in this man- 
ual by n, where n is a variable letter (see 
Table 1-2). 


RUBOUT or DELETE 


Deletes the last character typed on the cur- 
rent line and, if you press the key repeatedly, 
deletes contiguous characters to the left. 
Most CRT terminals remove each deleted 
character from the screen and move the print- 
ing position back one space. However, a 
hardcopy terminal prints a backslash (\), 
then each character as you delete it, then 
another backslash (\) before it prints the first 
correct character. For example: 

MISTKAE\EAK\AKE 


TAB 


Advances the printing position to the next 
tab stop. Tab stops occur after every eighth 
character position in the hne. In other words, 
the first tab stop is character (column) 9. 



These control keys will not always work as described here when you use 
them with various system programs. For example, some editing programs 
do not read CTRL/Z as an exit. Check the documentation for the system 
program you are using to determine its use of control keys. 

Table 1-2 describes the most commonly used control characters. 
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Table 1-2 Terminal Control Characters 



Character 


Description 


CTRL/C 


Gains the attention of the Monitor Console 
Routine (MCR), which interprets commands 
to the operating system. In most cases, the 
system responds to CTRL/C by displaying 
the explicit MCR prompt: 

MCR> 

This prompt indicates that the system is ready 
to accept input from your terminal. 


CTRL/0 


Alternately suppresses and resumes the dis- 
play of output at your terminal. 

For example, if you are running a program 
that generates unwanted output, type 
CTRL/O. The system then temporarily stops 
displaying output until you type CTRL/0 
again to resume output display. (If you do 
not type another CTRL/0, the system will 
discard the entire output and then return the 
default MCR prompt (>) to let you know 
output is finished . 


CTRL/S and CTRL/Q 


CTRL/S stops the display of output at your 
terminal until you type CTRL/Q to resume it. 
For example, if you are using a CRT terminal 
that displays output too quickly for you to 
read, type CTRL/S to halt the display. When 
you have read what is on the screen, type 
CTRL/Q to restart the output display. Repeat 
the process until you have read the entire file. 


CTRL/R 


Performs a carriage return and reprints the 
current line on your terminal, omitting any 
deleted characters, and making the line easier 
to read. Before terminating the line with a 
carriage return, type CTRL/R to ensure that 
you have made the right corrections. For 
example : 

MISTKAE\EAK\AKE-^R 
MISTAKE 
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Table 1-2 (Cont.) Terminal Control Characters 



Character 


Description 


CTRL/U 


Deletes the current line. This allows you to 
retype an entire line when individual correc- 
tions would be impractical. Remember that 
CTRL/U must be typed before the carriage 
return in order to delete that line. After the 
carriage return is entered, you must use an 
editing command from an editor to delete 
a line. 


CTRL/X 


Clears your terminal's typeahead buffer and 
enables you to type additional characters. The 
typeahead buffer is an RSX-1 IM feature that 
allows your terminal to save up to 36 charac- 
ters before it processes their commands. A 
"bell character" echoes on your terminal no 
matter what character you type when this 
buffer is full. CTRL/X clears the buffer and 
enables you to resume typing. 


CTRL/Z 


Exits from many RSX-1 IM system (and user) 
tasks and returns control of the system to 
MCR. 



Note the difference between the CTRL/O-CTRL/0 pair of commands and 
the CTRL/S-CTRL/Q commands: 

• When you type CTRL/0 after a previous CTRL/0, output dis- 
play resumes further down in the file than the point at which 
you hahed it with the first CTRL/0. 

• When you type CTRL/Q after a CTRL/S, output display begins 
where it stopped. The total output can still be displayed on 
your terminal. 

1.2 MCR COMMANDS 

The commands that interpret terminal input to control system operations 
are called Monitor Console Routine (MCR) commands. You communicate 
with MCR by entering a command line in the following form: 

commandname parameter(s)/keyword(s) line terminator 

commandname 

Consists of three or more letters, terminated by a space, that uniquely 
identify an MCR function. MCR only reads the first three letters. 
Additional letters merely help you identify the command. (The only 
exception to this 3-character rule is the HELP command. You must 
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type this entire command to distinguish it from the MCR HELLO 
command.) Some examples of MCR commands are given below: 

Command Function 

ABO[RT] Stops a running program 

DMO[UNT] Dismounts a volume 

UFD Creates a User File Directory 

parameter 

Specifies the object of the command function, which is usually a task 
or device. (A task is the basic executable program on an RSX-llM 
system.) One or more blank spaces must separate the parameter from 
the command name, or one parameter from another. For example, 
when you issue the ABORT command, you include the name of 
the running task to be aborted. The following command runs the 
taskADDTWOat 12:25:00 

RUNADDTWO 12:25:00 

The following command aborts the task ADDTWO: 

ABO ADDTWO 

/keyword 

Modifies either the actual function of the command or a parameter 
of the command. When a keyword modifies a command function, 
you must insert a space between the command name and the key- 
word. For example: 

commandname /keyword [=value] 

Wlien a keyword modifies a parameter of a command, the keyword 
immediately follows the parameter. In addition, some keywords are 
modified by an added numerical argument, shown in the examples as 
value. For example: 

parameter/keyword [=value] 

Spaces are also not required between consecutive keywords: 

parameter/keyword/keyword. . . 
commandname /key word /key word. . . 

For example : 

SET/CRT=TI: 
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This command tells the RSX-1 IM system that your terminal is a 
CRT. TI: is a pseudo device name that stands for the terminal you 
are using, that is the terminal from which a command was entered. 
In this case, CRT is the keyword that determines the function of 
the SET command. 

line terminator 

Represents either the carriage return <CR> or return key, or the 
altmode or escape key (<ESC>). Because <ESC> has a special 
meaning under certain circumstances, this manual uses <CR> as a 
terminator. Any terminator causes the hne to be sent to the com- 
puter or to the task waiting for input. 

Before typing a command, you must ensure that the terminal is in the 
right state to accept commands by: 

• Checking that the terminal's power is on 

• Checking that the LOCAL/REMOTE switch is set to REMOTE 

• Consuhing installation instructions for additional required 
terminal settings or instructions for using a dial-up line 

• Typing CTRL/C to obtain the explicit MCR prompt (MCR>). 

Both the expHcit MCR prompt and the default prompt (>) indicate that 
MCR is ready to accept input from your terminal. If you enter CTRL/C 
when you are using a system program other than MCR, you can issue one 
MCR command. The system executes that command and returns you to 
the task you were in when you entered CTRL/C. Both DIGITAL-supplied 
and user-written tasks can request input by displaying a task prompt at 
a terminal. 

NOTE 

If you are working with a system that does not 
support multiuser protection, you do not need 
to log on and off the terminal. Terminals con- 
nected to a nonmultiuser system are available 
to any user. Therefore, you can ignore the 
material in the remainder of this chapter. 

1.2.1 The HELP Command 

HELP is the only command (besides HELLO, the logging-on command) 
that you can issue from a terminal before you log on the system. Because 
the first three letters of HELP are the same as HELLO, you must enter the 
HELP command in full. When you issue this command, your terminal dis- 
plays text (determined by each instahation) that tells you how to log on 
and how to issue further commands. Even if you do not need help initially, 
issue the command at least once so that you know the nature of the infor- 
mation available to you from the system. 
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1.2.2 The HELLO Command 

To begin a session at the terminal, you must issue the MCR HELLO com- 
mand to log on. 

Logging on the system accomplishes several things: 

• It allows the system to make sure that you are an authorized 
user and to record information about your use of the system 

• It grants you the use of the terminal for access to the system 
until you log off 

• It establishes initial default values for your terminal activities 

The MCR HELLO command prompts for its parameters as follows: 

>heli::lo::i<cr> 

A C C U N T l-i; NAM E t I." <^ y m ::i < C R ::•• 
or 
:i. <i! iii t •- ri a m e < C R > 
PASSWORD t password<CR> 



[g,m] 



Commonly called a UIC and consists of two octal numbers that 
identify your account on the system. The first number (g) stands 
for your user group; the second number (m) is your member number 
within the group. The general UIC format consists of the two num- 
bers separated by a comma and enclosed in square brackets [g,m]. 
When you receive your UIC on a multiuser protection system, a 
User File Directory (UFD) with the same number is created for 
you. 

Although you have access to other UFDs on the system, your UIC 
remains the same, no matter which UFD you are working with. 



last-name 



Your last name, which you can enter instead of a UIC. The system 
determines your correct UIC from the name you specify. 



password 



A 1- to 6-character alphanumeric string. The system maintains 
account information, including correct passwords for each UIC and 
last name. You cannot gain access to the system unless you type the 
password corresponding to the UIC or name you have entered. 

The system does not print (echo) on your terminal the characters 
you type in response to the PASSWORD prompt. This ensures that 
your password remains private and that no one can log on using your 
account. 
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If you do not know your UIC or password, contact the system manager or 
whoever controls the use of your system. 

An example of the log-on procedure follows: 

::'|iei...<cr:> 

ACCOUNT OR NAME:C0NRAri<CR> 
PASSWORDS <CR> 

R ii) X •••• :l. :l. M B I... 2 A M IJ L.. J 1 ■•■■ U S E R S Y S J E. M 

GOOli AFTERNOON 

12-JAN-79 :l.:l. J07 LOGGED ON TERMiliNAL TT32? 

1.0-JAN-79 

SYSTEM WILL BE DOWN TODAY FROM :l.3{00 TO 
15:00 FOR CORRECTIVE MAINTENANCE 



When the system receives the correct password the terminal displays a 
message that includes system identification and the date and time you 
logged on the terminal. Notice the password is not echoed in the example 
above; this is the way your terminal will look when you enter your 
password. The terminal can display additional messages, which usually 
supply information that affects general use of the system. The default 
MCR prompt (>) on the line after the messages indicates that the mes- 
sages are complete and MCR is ready to accept commands. 

If the following message appears when you try to log on, someone else is 
using the terminal: 

HEL OTHER USER LOGGED ON 

Either try to log on a different terminal or find the person who logged on 
before you. Do not use the terminal without the other user's knowledge. 

The Quickest Ways to Log On 

Most users want to type as little as possible when using a terminal; they 
also want the quickest possible response time. This section describes ways 
to shorten the log-on procedure. 

Suppressing System Messages 

The HELLO command allows you to enter a special form of the UIC 
parameter to suppress the display of most of the system messages. (The 
system message file text can be written so that important messages cannot 
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be suppressed.) The normal format for a UIC is [g,m] . However, if you do 
not want to see the system messages, replace the comma with a slash (/) 
as follows: 

[g/m] 

HELLO allows four UIC formats: 

g/m 
[g/m] 
g,m 
[g,m] 

Either of the slash formats suppresses all but the most important of the 
system messages. When you log on, brackets around the UIC are optional. 
However, a UIC must always be specified in the format [g,m] when it is 
a parameter of any other command. 

Suppressing ACCOUNT OR NAME Prompt 

Another way to shorten the time required to log on is to enter the 
HELLO command and UIC (or last name) on the same line using a slash 
character as a separator: 

::h-iel 20 1/3:1. 2<c f;;> 
PASSWORD? <(:;r> 

This command format suppresses the prompt for ACCOUNT OR NAME. 

Automatic Execution of Log-On Command File 

After you log on a terminal, the system automatically assigns the name 
SY: to your system disk and then searches your UFD on SY: for the file 
LOGIN.CMD. If found, the system sends LOGIN.CMD to the indirect 
command processor, which executes all of the commands in LOGIN.CMD. 

This feature is useful when there are specific commands you issue each 
time you log on the system. 

For example, you could use your login command to set your terminal to 
be a CRT and to accept lower case letters. You could also include in the 
file a command to print a text file containing messages to yourself (just 
as the system prints a text file containing messages to all users when you 
log on). When you want to change the messages to yourself, you simply 
edit the text file MYLOGIN.TXT below. In this case, the following 
message is displayed on your terminal after the system messages: 
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::.-eL.aoiN.CMi:i 

>se:t /LOWEF^^:T:l:; 

>SET /crt^^=t:[: 

: PIP t:c;=~mylog»txt 

10:00 meet:i:ng with managers 

11; 00 racquetx:iai...i... with jack 

1.2} 30 finance committee meeting 

>(?<EOF> 

1.3 ERROR MESSAGES 

When MCR receives input that it does not recognize or that it knows to be 
incorrect, it displays a message on your terminal. An example is the mes- 
sage that appears if you try to log on a terminal already in use. You will 
receive a different message from MCR if you enter a UIC (or last name) 
or password that the system does not recognize: 

>HEL<CR> 

ACCOUNT- OR name: C0NRAK<CR> 

password: <gr> 

hel invalid account 



This attempt to log on was not successful, either because the system did 
not recognize the last name (CONRAK), or because you did not enter 
the correct password. 

The appropriate user response to an error condition depends on the 
message displayed. All messages returned by MCR commands are ex- 
plained in the RSX-1 IM/M-PLUS MCR Operations Manual. Command 
descriptions in that manual include a Hst of possible messages that the 
command can generate. The manual also includes an alphabetical list of 
all MCR messages. 

Each message a task prints on your terminal begins with the 3-letter name 
of the associated command or task sending you the message. When you 
encounter an error while running a system task, such as a text editor, 
look for an explanation of the message in the documentation for that 
task. 
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CHAPTER 2 
PROGRAM PREPARATION 

Four steps are required to prepare a program to run on RSX-1 IM: 

1 . Create a source file 

2. Compile or assemble the source file to produce an object 
module 

3. Link the object module to create a task image file 

4. Run the task (using an MCR RUN command) 

Each of the steps involves the manipulation of at least one file, which is 
an owner-named and created area on a mass storage volume (usually a 
disk or tape). 

When you log on a terminal, the system automatically allows you access 
to a disk. This disk is your default system disk on which RSX-1 IM stores 
all your files unless you specify otherwise. (If your system does not have 
multiuser protection, you have automatic access to a system disk that is 
also accessible to all users.) This chapter assumes you are using your 
default system disk. 

Note that the RSX-1 IM operating system lets you run programs written 
in a number of computer languages. The MACRO- 1 1 assembly language is 
always included with RSX-1 IM. Check with your system manager to see 
what other languages are available to you. 

Each language has its own system program (called an assembler or com- 
piler, depending on the language). This system program translates a source 
program into an object module and makes sure that the source program 
follows the language syntax rules. 

Each language compiler or assembler can only translate source files 
written for that language: the FORTRAN-IV program in this book must 
be compiled by a FORTRAN-IV compiler (see specific language documen- 
tation for more information.) 

Although this manual illustrates the creation of a FORTRAN-IV program, 
you follow the same steps to create a MACRO program, a COBOL pro- 
gram, or a program in any other compiled or assembled language. The 
only difference is in the language translator you use. 

2.1 CREATING THE SOURCE FILE (EDI) 

The RSX-1 IM Line Text Editor (EDI) is a system program you can use to 
create a source file. (You can also use EDI to create other types of files, 
such as text files and data files.) RSX~1 IM includes two other editing pro- 
grams: the DEC Standard Editor (EDT) and the Source Language Input 
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Program (SLP). EDT is especially useful with a CRT terminal because it 
lets you edit by character as well as by line. SLP is used primarily to 
maintain system programs. (See the RSX-11 Utilities Manual for docu- 
mentation of EDT and SLP, as well as additional information about EDL) 

This chapter uses a limited number of EDI commands to show you how to 
create and edit the source file for ADD.FTN. 

2.1.1 Using EDI to Create a Source File 

To invoke EDI, issue a call to the editor in the same way that you issue 
an MCR command. (Remember you can always type CTRL/C to get the 
expHcit monitor prompt and make sure your command is going to MCR.) 

>EEa<CR> 

EDI displays its task prompt: 

Era> 

To create a new file using EDI, specify a file name and a file type in the 
following form : 

E D I ::=• f :l 1 e n a m e ♦ f i 1 e t « p e 
filename 

A 1- to 9-character alphanumeric string, 
filetype 

A 3-letter abbreviation, preceded by a period (.). The abbreviation is 
usually related to the file's contents. The following are standard file 
types for programming language source files: 

Type Language 



BAS 


BASIC 


CBL 


COBOL 


,FTN 


FORTRAN 


,F4P 


FORTRAN-IV-PLUS 


MAC 


MACRO 



The following example, which is used throughout this chapter, illustrates 
the creation of a FORTRAN IV source file called ADD.FTN. ADD.FTN 
is an interactive program that prompts you to type two numbers at a 
terminal. The program then adds the two numbers and prints the result on 
your terminal. 
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EriT:><CF?> 

>EDI ADi:iJ"TN<CR> 

r CREMATING NEW f:i;i...e:i 

INPUT 

When EDI receives the name of a new file, it creates an empty file 
with that name and type and displays the two lines shown in the example 
above. EDI prints INPUT to let you know it is ready to accept input from 
your terminal. Anything you type except for control characters becomes 
part of the file called ADD.FTN. You can then type in the source program 
for ADD.FTN. When you terminate each line of input with a carriage 
return <CR>, EDI stores the line in a buffer. When you end the editing 
session, EDI writes the entire buffer to the file ADD.FTN. 

You can use the keyboard facilities described in Section 1.1 to correct 
any mistakes on the current line before you type <CR>. Once a line has 
been terminated and written to the buffer, you must use EDI commands 
to make any changes. 

You can also enter the new file name and file type on the same line as 
the call to EDI. This quicker way to create a file is illustrated below. Note 
the use of the DELETE or RUBOUT key, CTRL/R, and CTRL/U in the 
example : 

>EriI ADi:uFTN<CR> 
i: CREATING NEW FILE:I 
INPUT 

TYPE 1<CR> 
:L FORMAT (' ENTER TWO NUMBERS - M i-N ' ) -iiCR:: 

A P P E \ E P P \ C C E P r 2 y K y L "^ R 

ACCEPT 2yKi'L<CR> 

2 FORMAT <222\22\I5)<CR> 
PRINT"U 

TYPE 3i'Kfl...<CR> 

3 FORMAT (' THE SUM IS '»I5)<CR> 
STOP<CR> 

END<CR> 
<CR> 
*EX<CR> 

LEX it:] 

After you terminate the last line of text in the program, type a carriage 
return as the first character in the new line. EDI responds by displaying 
an asterisk (*) prompt. Until now, EDI was in Input Mode, the mode it 
entered to create a new file. Typing a carriage return (<CR>) at the 
beginning of a new line switches EDI to Edit Mode. The asterisk is EDI's 
prompt for commands. 
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The command EX [IT] instructs EDI to write ADD.FTN to your disk area 
and to return control of your terminal to MCR. 

The KILL command closes both input and output files and deletes the 
output file. It eliminates all traces of the current editing session. 

2.1.2 Editing an Existing File 

To edit an existing file with EDI, enter the same command you used to 
create a new file : 

>Ei:i]: A»»,FTN<CR> 

Because a copy of ADD.FTN now exists on disk, EDI responds differ- 
ently, as follows: 

>Ei:ii aih:uftn<cr> 
i::ooooe lines read in::i 
r:pAGE i::i 
* 

EDI creates a copy of ADD.FTN and enters Edit Mode, indicated by the 
asterisk (*) prompt. The message [00008 LINES READ IN] tells you the 
number of lines EDI has placed in its buffer. The lines in the buffer make 
up the text currently available for editing. The buffer may or may not 
contain the entire input file, depending on the size of the file and the 
buffer. To access text beyond the current buffer, issue a RENEW com- 
mand in Edit Mode. Renew writes the current buffer to the output file 
and refills the buffer with the next block of text. 

An internal line pointer determines the line within the buffer to be edited. 
When EDI reads in a buffer, the line pointer points to the line immedi- 
ately preceding the first line of text. This allows you to insert one or more 
lines at the top. You can subsequently reposition the pointer by searching 
for a particular piece of text or by using commands that reposition the 
pointer. 

Locating and Changing Text 

The EDI commands listed below allow you to find and change text in a 
file. You can abbreviate most EDI commands to one or two letters. In 
the following text, the optional portion of each command is in square 
brackets [ ] . 
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Command 

L[OCATE] 
C[HANGE] 
N[EXT] 

P[RINT] 
T[OP] 

BO[TTOM] 



Function 

Locates a string of text in the current buffer 

Replaces one text string with another 

Advances the hne pointer to the next line (EDI 
displays the Edit Mode prompt (*) but does not 
display the line) 

Displays the current line on your terminal 

Positions the line pointer at the top of the current 
buffer 

Positions the line pointer at the bottom of the 
current buffer 



<C1^ 



Points to and displays on your terminal the next 
line in a file 



An example of an EDI editing session is shown below with text explaining 
what each command does to change or to locate lines in the file and print 
them on the terminal. 

>Ei;i]: ADJ;uFTN<CR> 

i::ooooa lines read :i:n::i 

CPAGE 11 

♦LOCATE ENTER<CR> 

1 FORMAT (' ENTER TWO NUMBERS •■ M '^ N ' ) 

* 

The LOCATE command in the example above points to and prints the 
next line in the file (after the current line) containing the word ENTER.) 



*CHANGE/ENTER/TYPE/<CR> 

:l. FORMAT ( ' TYPE TWO NUMBERS 

* 



MvN' ) 



The CHANGE command above changes the word ENTER to TYPE. Note 
that the slash characters (/) are used to delimit both the old and the new 
text strings. Any ASCII characters that are not used in either string can be 
used to delimit a string. EDI then prints the corrected line on your 
terminal. 

*NEXT<CR> 
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The NEXT command points to the next line in the text, but does not 
print it on your terminal. 

*PR'1NT<CR> 

ACCEPT 2!'Kyl... 
* 

The PRINT command above displays the current line on your terminal. 

* LOCATE SUM<CR> 

3 FORMAT (' THE SUM IS ' vl'5) 
* 

The LOCATE command points to and prints the next line in the file con- 
taining the word SUM. 

#CHANGE/SUM/RESULT/<CR> 

3 FORM AT (' THE RESULT IS '^:i:5) 

* 

The CHA.NGE command above changes the word SUM to RESULT. 

♦ LOCATE < 2.1:5 )<CR> 
OKEOB*^ 

The LOCATE command searches for a line containing (215). In this case, 
EDI reaches the end of the buffer (EOB) without finding the string (215). 
The EDI line pointer only moves forward through the buffer in response 
to a LOCATE command. It does not search backward through a file. 

>HTOP<CR> 
* 

The TOP command moves the line pointer to the top of the buffer (one 
line before the first line of text). At that point, Edit Mode displays the 
asterisk prompt (*). 

« <CR> 

TYPE :l 
* 

When you enter a carriage return in response to the asterisk prompt EDI 
prints the next line on your terminal. The carriage return also moves the 
EDI line pointer to the next line. Therefore, it performs the same func- 
tion as the NEXT and PRINT commands. In this example the pointer 
points to the first line in the buffer. 
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>KEX:[T<CR> 

i:exit::i 

The EXIT command writes the current buffer and the remainder of the 
input file to the output file, closes both input and output files, and exits 
from EDI to MCR. 

Inserting and Deleting Text 

The EDI commands listed below allow you to insert and delete text in 

the file. 



Command 

I[NSERT] 
A[DD] 
D[ELETE] 
<ESC> 



R[ETYPE] 
LI [ST] 



TYPE n 



Function 

Inserts one or more new lines of text in a file. 

Adds text to an existing line. 

Deletes the current line. 

Points to and prints the previous line. Note, how- 
ever, that <ESC> does not display the line you 
just entered with an Insert command. It moves 
the pointer up one line in the text and displays 
that line. 

Replaces the current line of text with a new line. 

Prints on your terminal the lines remaining in the 
buffer, from the current Hne to the end. After the 
LIST command executes, the line pointer is reset 
to the top of the buffer. 

Prints on your terminal the next n lines, but does 
not reset the line pointer. 



An example of an EDI editing session is shown below with text explaining 
what each command does to insert or delete text. 

>ed:i: add*ftw<cr> 

i: 00000 LINES READ :i:n::i 

i::page :i.::i 

EDI retrieves the latest version of ADD.FTN. Note that if you want to 
edit an earlier version of ADD.FTN, you can include a version number in 
this command. 



2-7 



Program Preparation 



*INSERT<CR> 

C TH:i:S PFI:0(3RAM adds two NUMBER8<CR> 

<CR> 

*<ESC> 
C*B0B*:.1 

<CR> 

C THIS PROGRAM ADDS TWO NUMBERS 

The EDI INSERT command in the text above switches to EDI Input 
Mode and inserts text immediately before the first line of text already in 
the buffer. The second carriage return takes you back to Edit Mode. The 
<ESC> command from Edit Mode causes EDI to display the line before 
the current line. In this case, the line before the current line is the begin- 
ning of the buffer [*BOB*] . The carriage return moves the pointer to the 
line you just inserted, which is now the first line of the text. 

♦locate NUMBERS<CR> 

.1 FORMAT (' TYPE TWO NUMBERS •• MvN') 

♦add ! PROMPT FOR ;i:nput<cr> 

*PRINT<CR> 

1 FORMAT (' TYPE TWO NUMBERS - M»N') "PROMPT FOR INPUT 

* 

The LOCATE command finds the line on which a string occurs, the ADD 
(append) command attaches a comment text to the line, and the PRINT 
command displays the revised line. 

♦locate RESULT<CR> 

3 FORMAT (' THE RESULT IS 'yI5) 

*riELETE<CR.> 

The DELETE command deletes the current line and moves the pointer to 
the next line. 

♦•='ESr ■=■ 

TYPE 3i.KfL 

* 

The <ESC> command causes EDI to point to and print the previous line 
in the buffer on your terminal. 

*INSERT<CR> 

3 I'- R M A T ( ' T H E S U M I S ' vl5) \ D 1 S P L A Y R E S U I... T < C R >• 

<CR> 
* 
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EDI enters insert mode and inserts a new line of text. The second carriage 
return causes EDI to reenter Edit Mode at the current line. 

* TOP<CR> 

♦ <CR> 

C THIS PF«:)GRAM ADDS TWO NUMBERS 

*;RETYF'E C ADD DISPLAYS THE SUM OF TWO NUMBERS<CR;> 

* 

The TOP command repositions the line pointer to the top of the buffer. 
The carriage return points to and prints the next line, which in this case is 
the first line in the buffer. The RETYPE command replaces the current 
line with the text that follows the command. 

)KLIst<cr:> 

c add displays the sum of two numbers 

TYPE 1. 

1 FORMAT (' TYPE TWO NUMBERS ■■•• M»N')! PROMPT FOR INPUT 
ACCEPT 2>KyL 

2 FORMAT (215) 
TYPE 3vK+L 

3 FORMAT (' THE SUM IS ' i- 15 )! DISPLAY RESULT 
STOP 

END 



The LIST command displays the lines from the current line to the end of 
the buffer. 

>K EX<CR> 

i;:exit:] 



When you issue the EXIT command, EDI writes the file to your disk area 
and returns control to MCR. 

2.1.3 Basic EDI Commands 

Table 2-1 summarizes the basic set of EDI commands. These commands 
provide all the functions you need for simple editing. 
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Table 2-1 Basic EDI Commands 



Command 



A[DD] string 



BO[TTOM] 



C[HANGE] /string l/string2/ 



<CR> 



CTRL/Z 



D[ELETE] 



<ESC> 



EX[IT] 



I[NSERT] string 



KILL 



L[OCATE] string 



N[EXT] 



P[RINT] 



REN[EW] 



Description 



Appends string to the current line. 



Moves the line pointer to the bottom 
of the current buffer. 



Replaces string 1 with string2 in the 
current line. 



When in Input Mode, <CR> returns 
you to edit mode. 

When in Edit Mode, <CR> prints 
the next line on your terminal and 
moves the line pointer to that line. 



Closes the input and output files and 
terminates the editing session. 



Deletes the current line. 



Points to and prints the previous line. 



Closes the input and output files and 
terminates the editing session. 

Inserts string before the next line or 
enters input mode if string is omitted. 



Closes both input and output files 
and deletes the output file. 

Locates the next line containing the 
object string. The search stops at the 
end of the current buffer. 



Advances the line pointer to the next 
line. 



Prints the current line on your 
terminal. 



Writes the current buffer to the out- 
put file and reads in another buffer 
from the input file. 
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Table 2-1 (Cont.) Basic EDI Commands 



Command 


Description 


R[ETYPE] string 


Replaces the current line with the 
object string. 


T[OP] 


Moves the line pointer to the top of 
the buffer. 


TYPE 


Prints on your terminal the next 
n lines but does not reset the Une 
pointer. 



2.2 COMPILING A FORTRAN-IV SOURCE FILE 

After you have created a FORTRAN-IV source file, in this case ADD.FTN, 
the next step is to compile the program into machine-readable (binary) 
form. This compiled program is called an object module. 

2.2.1 Creating an Object Module 

You begin the compilation process by issuing a call to the FORTRAN-IV 
compiler (in the same way you issued a call to the editor, EDI): 

>FOR ADD ♦ OB J==-"ADD ♦ FTN<CR> 



^i*^' 



This command line tells the FORTRAN-IV compiler to compile the 
source file ADD.FTN to produce an object module called ADD .OBJ. As 
the example shows, you specify from left to right the output file (ADD.- 
OBJ), an equal sign (=), and the input file (ADD.FTN). 



NOTE 

RSX-1 IM command line specifications follow 
the convention used by many computer lan- 
guages: the output of a process appears to the 
left of the equal (=) sign and the input to the 
process appears to the right. (See Chapter 3 for 
more information on file specifications.) 

The FORTRAN-IV compiler defaults the object file type to .OBJ and the 
source file type to .FTN. This means that if you do not include a file type 
with the file name in a command to the compiler, FORTRAN searches for 
a file with the name you supply and a file type of .FTN. If it finds one, it 
uses that file as input. FORTRAN creates a file with a type of .OBJ as 
output if you do not specify an output file type. 
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Most RSX-llM system programs and all language processors use defaults 
in this way. For this reason, you should use the standard file types when- 
ever possible. (Additional standard file types are described in the RSX- 
IIM/M-PLUS MCR Operations Manual and are listed in the RSX-llM 
Mini Reference.) 

The default file types in the FORTRAN-IV command line are shown in 
Table 2-2. 

Table 2-2 Default FORTRAN-IV Compiler File Types 



File 


Default File Type 


Input 


Output 


Source File 


Listing File 
Object Module 


.FTN 
.LST 
.OBJ 



Using the defaults, you can shorten the above command to: 

>FDFv' ADLi==ADEi<CR> 

By appending switches to the input and/or output file specifications, you 
can make special compilation requests. (See the IAS/RSX-11 FORTRAN 
IV User's Guide for a description of the FORTRAN-IV compiler 
switches.) All of the examples in this section assume you are using the 
compiler defaults. 

2.2.2 Creating a Listing File 

In addition to translating a source program to an object module, the 
FORTRAN-IV compiler can also supply a listing file and a storage map for 
the program. To create a listing file you enter the command: 

> FOR ADD 9 Arii:i=--=Ai:iD<CR> 

The second ADD on the output side of the command instructs the com- 
piler to produce a listing file and storage map (called ADD. LST) for the 
source program. The listing file provides information on compiler errors 
and the storage map lists the symbolic names used in the program and 
flags references to symbols that will have to be resolved by the Task 
Builder. 

If the system includes the Queue Manager and spooling to a line printer, 
the FORTRAN-IV compiler automatically puts ADD. LST in the line 
printer queue. You can inhibit this automatic printing with the following 
command line : 

> F' R A m:i 1- A nil / ■ - s p ■■■■■■= a d n < c R > 
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The -SP switch tells the compiler not to spool the listing. 

The compiler also stores a copy of ADD.LST on your system disk. (If 
your system does not include spooling, the compiler only stores the file 
on disk.) 

The FORTRAN compiler can also produce a listing file of your program 
without creating an object file. This feature enables you to find errors in 
your program using the listing file, without generating multiple versions 
of unusable object files. To produce only a listing file, enter a command 
in the following form : 

>F(:)R yADD::=Ai:iD<CR> 



Following this command, ADD.LST is both spooled to the line printer on 
systems with spooling and also stored on your disk area. 

Note that you must enter a comma before the listing file specification in 
the command line; otherwise the compiler interprets ADD as an object 
module instead of a listing file. 

The following command causes a copy of ADD.LST to be displayed at 
your terminal but not printed on the line printer or saved on disk: 

>FC)R addi.t:i:j=^«adi:i<cr> 

2.2.3 Requesting a Nonresident FORTRAN-IV Compiler 

In some cases, you may issue the FOR command and receive the message: 

MCR •■ TASK NOT :i:N SYSTEM 

This means that the FORTRAN compiler is not currently installed on 
your system. To install the compiler, issue the MCR command: 

>RUN $FOR<CR> 

This command tells the system to install the FORTRAN compiler in 
memory and to activate it at your terminal. The compiler responds with 
the prompt: 

FOR> 
You then enter the FORTRAN-IV command as illustrated previously : 

F R > A D D y A D D ^- A H D < C R > 
FOR>->Z 



2-13 



Program Preparation 

After the compiler executes your commands, it displays the task prompt 
(FOR>) once again. At this point, you can compile additional FORTRAN 
programs or exit from the compiler. Enter CTRL/Z to terminate the com- 
piler and remove it from memory. (See the RSX-UM/M-PLUS MCR 
Operations Manual for details on the RUN command.) 

2.3 BUILDING A TASK IMAGE 

The RSX-llM Task Builder converts the object modules created by a 
language translator into a single task image file. This task image file 
resides on disk until someone issues an MCR command to install and run 
it. (You may have used computer systems which referred to some parts of 
the Task Building process as linking or loading.) 

2.3.1 Full Task Build Command Line 

A full Task Builder command line uses three output files and any number 
of input files. The output files are: 

1. The task image file (filename.TSK) which contains the task 
image to be installed and run 

2. A memory allocation file (filename.MAP) which contains infor- 
mation about the size and location of various parts of the task 

3. A symbol definition file (filename. STB) which contains infor- 
mation about the task's global symbol definitions (The STB 
file is not needed or created in most Task Builder operations.) 

The input files include all of the object modules and modules from system 
or user libraries required to produce a single task image. The full Task 
Builder command line is: 

>TKB task image file, map file, symbol definition file=object file(s) 

Table 2-3 illustrates the default file types in the Task Builder command 
line. 

Table 2-3 Default Task Builder File Types 



File 


Default File Types 


Input 


Output 


Object File 


Task Image File 
Task Builder Map 
Symbol Definition 


.OBJ 
.TSK 
.MAP 
.STB 
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To Task Build ADD.FTN, issue the following command: 

> TKB ADD ♦ TSK » ADD ♦ MAP y ADD . STB«=-AIin , OBJ » LB J C 1 r 1 3F0R0TS/LB<CR:: 

In this command, LB: is a pseudo device name for the device containing 
the library, [1,1] is the UFD where the Ubrary is stored, and FOROTS 
is the FORTRAN Object Time System Hbrary. The RSX-llM/M-PLUS 
Task Builder Manual describes the use of the LB switch to include OTS 
libraries in task image files. 

Using Task Builder defaults, the command can be shortened to: 

> TKB ADD f ADD y ADD=""ADD f LB U! 1 r .1. :iFOROTS/LB<CR> 

2.3.2 Short Task Build Command Lines 

Like the compiler, the Task Builder allows you to omit any output file 
or to direct output files to your terminal or to a line printer. However, 
if you omit an output file in the beginning or middle of the output side of 
a file specification, you must retain the comma in place of the file name 
to specify a null (empty) field. On the input side of the command, use a 
comma to separate one input file from another. Table 2-4 illustrates the 
creation of Task Builder output files. 

Table 2-* Task Builder Output Files 



Command Line 


Output Files Generated 


>TKB .TSK,.MAP,.STB=.OBJ 


All three output files 


>TKB „.STB=.OBJ 


Symbol definition file only 


>TKB ,.MAP,.STB=.OBJ 


Memory allocation and symbol 
definition files 


>TKB .TSK„.STB=.OBJ 


Task image and symbol defini- 
tion file 


>TKB .TSK„MAP=.OBJ 


Task image and memory alloca- 
tion files 


>TKB .TSK=.OBJ 


Task image file only 



2.3.3 Multiline Task Build Command Procedures 

A long list of input files can cause a Task Builder command line to exceed 
the terminal's maximum line length. If this happens, you can invoke the 
Task Builder in the following manner: 

>TKB<CR> 
TKB> 
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After you enter the carriage return, MCR activates the Task Builder, 
which then returns the TKB> prompt. The Task Builder displays its 
prompt after each line of input until you enter two slash characters (//) 
and a carriage return at the beginning of a line. The slash characters ter- 
minate operation of the Task Builder and return you to MCR. For 
example, the single command line: 



>TKB 

TKB> f i 1 nam . TBK i- f i I nam . MAP » f .i 1 nam » STB==f :i. 1 nair. ♦ OBJ » OBJ > OBJ <.V,R.- 

can be entered as: 

TKB> f i 1 nam ♦ TBK y f :l I nsm . MAP » f i I nam * 8TB=^f :L 1 nam J. . GB J<CR> 
TKB> f i 1 nam2 . OBJ ? f :l 1 nam3 . OB J<CR> 
TKB> //<CR> 



2.3.4 Listing the Memory Allocation (MAP) File 

The memory allocation file (map file) is an ASCII file that contains infor- 
mation about the size and location of components within the task. If your 
system includes the queue manager and print spoohng options, the Task 
Builder spools the file to the line printer by default. 

Without the spooling option, however, the Task Builder only stores the 
file on your system disk. 

2.3.5 Task Builder Switches and Options 

The Task Builder includes a variety of switches and options to control the 
creation of a task image on disk. These switches and options are described 
in detail in the RSX-1 JM/M-PL US Task Builder Manual. 

2.4 RUNNING A TASK 

To run the task you created, issue an MCR RUN command as follows: 

> RUN ADD <CR> 
The RUN command instructs the system to: 

• Locate ADD.TSK on your default system disk 

• Load a copy of the task image into memory 

• Execute the task 
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When you use this form of the RUN command, the task image file remains 
on disk, ready to be run again, until it is explicitly deleted. 

The following sections illustrate three successful executions of the 
FORTRAN-IV program ADD.TSK. Remember that ADD is an interactive 
program; that is, it prints a message on your terminal and then waits for 
you to type in a response before it performs the calculations and prints 
the result on your terminal. 

>RUN ADri<CR.> 

TYPE TWO NUMBERS - hs-N 

7»3<CR> 

THE SUM IS 10 

TT47 -- STOP 



>RUN ADD<CR> 

TYPE TWO NUMBERS •• HvH 

!^22y628<CR> 

THE SUM :i:s :I.:1S0 

TT47 •••-• STOP 



>RUN aiii:i<cr:> 

TYPE TWO NUMBERS ••• M)-N 

9»:l.6<CR> 

THE SUM IS 2S 

TT47 ~- STOP 



Note that when the program completes execution, it displays the line: 
TT47 STOP 

TT47 is a temporary name assigned to the task when you issue the RUN 
command. The version of the RUN command used in this example causes 
the system to name the task TTn, where n is the unit number of the ter- 
minal running the program. 

Figure 2-1 reviews the steps to creating the FORTRAN-IV task ADD, 
including the specific files created in each step. 
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>EDI 



EDITOR 



>FOR 




LISTING 



>TKB 




TASK BUILDER 
MAP 



SYMBOL 

DEFINITION 

FILE 



>RUN 



EXECUTING 
TASK 



Figure 2-1 Development of a FORTRAN-IV Task 
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CHAPTER 3 
THE FILES 



The RSX-1 IM file specification is used by all RSX-1 IM system programs, 
including editors, compilers, utilities, and the Task Builder. 

The examples in Chapters 1 and 2 emphasized using defaults in command 
line file specifications. Defaults are useful because they allow you to use 
the resources of the system without understanding every possible choice 
available to you. They also permit you to do less typing. In many situa- 
tions, however, you will need a complete file specification, because de- 
faults alone will not cause the system to do what you want it to do. 

The format of a full file specification is: 

dev: [g,m] filename. filetype;fileversion 

dev; The name of the device that holds the volume on 

which the input file resides (or on which the out- 
put file will reside). 

[g,m] A User Identification Code (UIC) identifying the 

User File Directory (UFD) that contains (or will 
contain) the file. 

filename The 0-9 character name you supply for the file. 

filetype The 0-3 character type you supply for the file. 

fileversion An octal number that distinguishes between dif- 

ferent versions of the same file. 

Examples of full file specifications are: 

MTl:[116,23]CHARLA.FOO;32 
DM1: [203,204] F00.FUM;5 
DK2: [34,63 ]WH0.F00;3 

Chapter 2 describes the file name and file type fields of a file specification. 
The following sections describe the device name and UFD fields. 

3.1 THE DEVICE NAME 

The device name specifies the volume on which the file resides. The name 
consists of two alphabetic characters and an optional 1 - or 2-digit octal 
unit number followed by a colon (:). When the name does not include a 
unit number, the system tries to use unit number 0. 
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Device names in the above examples and their corresponding abbreviations 
are listed below. 

Name Physical Uni t 

DK2: RKO 5 disk, unit 2 

DM1 : RK06 disk, unit 1 

MT 1 : TU 1 , TE 1 , or TS03 magnetic tape , unit 1 

The device name can refer to one of two kinds of devices: 

• An actual physical device, such as the three listed above 

or 

• A pseudo device which can represent a variety of physical units, 
depending upon which terminal enters the unit name 

For example, the name TI: is a pseudo device that refers to the terminal 
from which input is being entered. When you enter input from terminal 
23 on your system, your physical terminal number is TT23: and your 
pseudo terminal is TI:. When you enter input from terminal 6, your 
physical terminal number is still TT6 : but your pseudo terminal remains 
TI:. 

Therefore, you can either write a program to send output to TT23 :, which 
means you will always have to run the program from TT23:, or you can 
write it to send output to TI:, which means it will always send output to 
whatever terminal installs and runs the task. 

Another pseudo device name is SY:, which corresponds to your default 
system disk. All the files created so far in this manual reside on SY:. 

Section 2.3.1 describes the pseudo device LB:, the volume that contains 
libraries. 

Table 3-1 lists commonly used devices. The letter n stands for the unit 
number of the device. There are different types of disks and magnetic 
tapes, which have correspondingly different device names. Ask some- 
one familiar with your system which names you should use. (See the 
RSX-llMlM-PLUS MCR Operations Manual for a complete list of device 
names.) 
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Table 3-1 . Device Names and Abbreviations 



Device 


Abbreviation 


DECtape 


DDN; 
DTn: 


Disk 


DBn: 

DFn: 

DKn: 

DLn: 

DMn: 

DPn: 

DRn: 

DSn: 

DXn: 

DYn: 


Line Printer 


LP: 


Magnetic Tape 


MMn: 

MSn: 

MTn: 


Pseudo Terminal 


TI: 


Terminal 


TTn: 


Pseudo System 
Device 


SY: 



Because the names SY:, TI:, TT:, and LP: represent input or output 
devices rather than storage media, they usually do not appear in a com- 
plete command line. When you refer to one of these devices in a command 
line, the device name stands alone on one side of the equal sign. For ex- 
ample, the following command sends a copy of ADD.FTN from your 
system disk to your terminal: 

:::.p:[p t:[j^:::ai:ii:uftn<cr> 

C ADD DISPLAYS THE SUM OF TWO NUMBERS 
TYPE :l. 

1 FORMAT ('TYPE TWO NUMBERS -M vN ')! INPUT PROMPT 
ACCEPT 2yKyL 

2 FORMAT (215) 
TYPE 3 y KiL 

Z F R M A T ( ' T H E S U M 1 S ' y 1 5 > ! D I S I-' I... A Y R li- S U 1... T 

STOP 
END 
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3.2 USER FILE DIRECTORIES ^^ 

When you log on, you either use your login UIC itself or specify it in- 
directly by using your last name. This UIC identifies the default User File 
Directory (UFD) set up for you on your system disk (SY:) when the sys- 
tem manager made you an authorized user. This UFD is itself a file that 
lists the names of all files stored in your directory. None of the system 
programs can locate a file unless they know the UFD in which the file is 
listed. 

The terms UIC and UFD are often used interchangeably in RSX-1 IM. The 
UIC, however, identifies the user and the UFD identifies the directory. 

When you need to use files stored in other directories, you can use an 

MCR SET command to change your default UFD (SET /UIC=[g,m]) or 

you can specify a UFC in the file specification. The MCR SET command 

changes the default UFD. However, neither of these actions changes the Jli^ 

UIC under which you logged on. 

For example, if you want a copy at your terminal of a file from another 
UFD, issue the command: 

>p :i; p T :i: ; ^^^ i:: 3 o 2 c 2 ::i c; n r a i:u m a c < z r > 

This command assumes that CONRAD.MAC resides on your default sys- 
tem disk, in UFD [302,200] . '^^ 

In a system without multiuser protection, your default UFD corresponds 
to the UIC specified in the last SET /UIC command issued from the 
terminal you are using. 

To display the current defauh UIC on any system, issue the command: 

>SET /u:i:c<cR> jm^ 

When you issue a set command in this form, without specifying what 
UIC is to be set, the system responds with: 

uiC"H::£SHri:j 
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CHAPTER 4 
PIP AND THE QUEUE MANAGER 



The following sections introduce two utilities, the Peripheral Interchange 
Program (PIP) and the Queue Manager, and show you how to use these 
utilities to copy files, list the files in a directory, delete, rename, and 
purge files, and print files on a line printer or display them on your 
terminal. 

4. 1 PERIPHERAL INTERCHANGE PROGRAM 

The Peripheral Interchange Program (PIP) manipulates files on RSX-llM 
by using appropriate switches to perform the operations. 

Among other things, PIP allows you to 

Copy files from one UFD or device to another 

Delete files 

Rename files 

List directories of files 

Purge files 

Any volume you refer to in a file specification must either be allocated as 
public (available to all system users) or be allocated to you (on multiuser 
protection systems only) and mounted. If any volume specified or implied 
in a PIP command is not mounted or is allocated to another user, PIP 
returns the message: 

p:i:p DEv:i:cE mn mounted/allocated 

Device allocation, mounting, and UFD creation are all MCR functions 
accompHshed by the following MCR commands: 

• ALLOCATE 

• MOUNT 

• UFD 

(See the RSX-IIM/M-PLUS MCR Operations Manual for a description of 
these commands.) In the process of creating, editing, compiling and Task 
Building ADD.FTN, RSX-1 IM created a number of files on disk: 

• The original source file (ADD.FTN; 1 ) 

• An edited version of the source file (ADD.FTN;2) 

• An object file containing the compiled program (ADD.OBJ;!) 
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• A task image file containing linked object code (ADD.TSK;1) 

• A memory allocation file (ADD.MAP;1) 

• A symbol definition file (ADD.STB;1) 

• Additional versions of the above files, if you repeated any of 
the program preparation steps 

All of these files remain on disk taking up space until you exphcitly delete 
them. RSX-llM does not automatically eliminate old versions of files. 
(Appendix A includes an example of how consecutive operations can 
create multiple copies of files.) 

You can invoke PIP from MCR in either of two ways: 

1 . The single line format, which executes one PIP command and 
returns control to MCR: 

>p:i:p /i...:i:<CR> 

D :i: f;: i;l' c r o r y d b o % i;; 3 1. •> 3 :i. 4 ::i 

.1.4-FI;:B-79 09{:l.0 



ADDJ 


^•TNy3 


:L. 


2 2 -FEB •■•■7 9 


:l:i. 140 


A DIM 


■•IN 5 2 


2» 


22-FEB-79 


:i.2?oo 


ADDJ' 


"TNM. 


:l. ♦ 


:l 9 -FEB -■7 9 


:l.:l. S32 



or 
2. The format that passes control to PIP and allows you to execute 
multiple PIP commands: 

>p:i:p<cr> 
Pip> /l:i:<cr> 

D :i; R E c; t' r y d b i i;; 3 :i. ,2\ai 

:l.4-FEB-79 09?:l.0 



ADD ♦FIN 5 3 


.1.* 


22-1 


"•EB-79 


:l.:l. MO 


ADDJ"TN?2 


2* 


22-f 


•EB-79 


1.2? 00 


ADD J-TN?:!. 


:l. , 


:l.9-l- 


■EB-79 


:l.;i. J32 



TOTAL OF 4«/:L:l, , BLOCKS IN 3. FILES 
P I P> ADD ♦ FIN /PU<CR> 

p:i: p>'-z 



This chapter uses the one-line form shown in number 1 to illustrate PIP 
command operations. Any command shown here can also be executed in 
the method described in number 2. 
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4.2 PIP COMMAND LINE AND DEFAULTS 

The format of PIP command lines differs for each function. In general, 
however, PIP switches operate on Hsts of file specifications. PIP uses the 
last value it encounters in a command line as the default value for that 
command. 

You can enter multiple file specifications in a single command Hne by 
separating the individual file specifications with commas. The switch 
follows the last file specification. 

In the following example, PIP will delete the files named ARRAY.FTN;1, 
MULT.FTN;1 and HEX.FTN;1 : 

;::• p :i; i--- m<.rm . f r n pi i- m u i... i » f t n ? :!. v i -i i;;: x , i-' i n ? :i. / d e < z r > 

The individual file specifications within the Ust must each meet the 
requirements of the PIP switch involved. Therefore, all of the files being 
deleted in the example must include version numbers because the PIP 
Delete switch requires version numbers. 

Table 4-1 summarizes the PIP switches which are described in this chapter. 
(See the RSX-11 Utilities Manual for additional information on PIP.) 

The following sections describe and illustrate the use of these commands. 

4.2.1 Displaying a File on Your Terminal 

To display a copy of ADD.FTN on your terminal, enter a PIP command 
in the following format : 

>p:i:p t:i:{:::=adiuftn<cr> 

This command produces the following display: 

TYPE 1 
:l FORMAT (' TYPE TWO NUMBERS - Mi-N') ! PROMPT FOR ifNPUT 
ACCEPT 2»KyL 

2 FORMAT (215) 
TYPE ;3?KfL 

3 FORMAT (' THE SUM IS ' vV5) ! DISPLAY RESULT 
STOP 

END 
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Table 4-1 PIP Switches and Command Functions 



Switch 


Meaning 


Description 


/LI 


List 


Prints the names of requested files con- 
tained in the specified UFD. 


/BR 


Brief 


Prints a shortened version of the directory 
generated by the list command. 


/DE 


Delete 


Deletes the files specified. 


/PU 


Purge 


Purges (deletes all but the highest num- 
bered version(s)) of the files specified. 


/SP 


Spool 


Spools (lists on the line printer) all files 
specified. (Note that you can also use the 
Print command of the Queue Manager for 
this function.) 


/RE 


Rename 


Renames the input file(s). 


/CO 


Contiguous 


Copies the file into contiguous blocks on 
the output volume. 


/TR 


Truncate 


Truncates unused blocks at the end of the 
file. 


/CD 


Creation Date 


Copies the file, using the original creation 
date, instead of updating it to the current 
date. 


/SD 


Selective 
Delete 


Deletes the files specified, after asking you 
whether you want to delete each particular 
file. 



4.2.2 /LI - Displaying Your User File Directory 

All of the files you create are listed in your UFD. The PIP /LI command 
displays the UFD as follows: 



=H^ 
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>p:cp /i,j:<(:;r> ip 

DIRECTORY DBO } lii 2:1.0 o 76 iJ 
10 FEB •••■7 9 :l.4t48 



ADD ♦OBJ? 2 




2. 




25- 


•JAN- 


••79 


14 J 3.1. 


ADD.TSKP1. 




.1.9. 


C 


20- 


•JAN- 


••79 


14 2 32 


ADD.MAPf:!. 




4* 


c; 


25- 


•JAN- 


•79 


14 J 32 


ADD,STB?:l. 




3. 




:l.2- 


•JAN- 


•79 


10 2 37 


ADDJ"TN?1 




:l. . 




:l.0- 


-JAN- 


••79 


8? 16 


ADD.TSK?3 




29 ♦ 


C 


a- 


•JAN- 


•79 


12 2 01 


add*qbjp:i. 




2. 




29- 


•DEC- 


•78 


13 2 06 


ADD.TSKP2 




29. 


C 


29- 


■DEC" 


••78 


13 2 04 


TOTAL OF 99. 


./:n.2. 


BLOCKS 


.IN 8 


FILES 









The PIP /LI version of the command includes the following information, 
keyed to the numbers in the directory above: 

49 The physical volume on which the files are stored, and the UIC 
that owns the directory. The volume named is your default sys- 
tem disk (SY:). The UIC is your default UFD. 

O The date and time PIP created the directory Hsting. 

O The name, type, and version number of each file. 

® The number of blocks used by each file. A block is 512 bytes 
(256 words) long. 

® A file code which indicates the file is either contiguous (C code), 
noncontiguous (no code), or locked (L). Locked files usually 
contain corrupted data. You can access them by using the PIP 
Unlock switch (PIP filename/UN). 

® The date and time pach file was created. 

® The cumulative size in blocks of all the files Hsted and the num- 
ber of blocks allocated to all the files. 

PIP also provides switches to control the amount of detail given in the 
directory listings. The BR switch causes PIP to generate a directory in 
brief form. For example, the command PIP /BR causes PIP to print a 
directory on your terminal in the form: 



4-5 



PIP and the Queue Manager 

DIRECTORY DBl J 1303 s- :l.2::i 

ADi:urTNv3 
ADi:uFTNr2 
AMU FIN 5:1. 

The FU switch causes PIP to print a directory in more detailed (full) form, 
as shown in the following example: 

PIP /FU<CR> 

D I RUCTORY DB 1 X 1 303 y 1. 2 ::i 

21 -FEB"?? .1.4 M9 ^ _ 

o o 

AnBtFTN>3 (1437? 27) 73./73» ^ 20-FEB-79 14:23 

o o 

[:303fl2:3 LRWEByRWEDyRWEDs-R::! 21"FEB='=7? 14J07(4t) 

ADri.FTNP2 ( 6206 » 22) 57. 757. 20-FEB-7? 13 J 41 

C303»123 r:RWED>RWED»RWED»R:i 21-FEB ■••■79 14:22(4.) 

ABB. OBJ »1 (21 142 » 3) 66.766. 20"FEB^^79 13.19 

I:303t12;] C:RUIEByRWEByRWEB»R:] 21^^FEB^^79 14:22(4.) 



This form provides the following information (in addition to the informa- 
tion explained in the preceding example); 

A file identification number consisting of the file number and 
the file sequence number. This information is used by the 
RSX-1 IM file system to keep track of your files. 

O Blocks allocated to each file (in addition to the blocks used). 

O A protection code which tells how your file can be accessed 
by other system users. 

The date and time the file was last revised and the number of 
revisions. 

After displaying the directory in any of these forms, PIP returns control 
to MCR. 

4.2.3 Display Information on Specific Files 

PIP allows you to obtain information about one file or a specific group of 
files in a directory. For example, if you want to see how many versions of 
ADD.TSK exist in your directory, issue the command: 

>V'IP ADD.TSKd* /L:r<CR> 
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As the example illustrates, the file specification always precedes the 
switch. 

The command requests PIP to display a directory of all versions of the file 
called ADD.TSK. The asterisk (*) in the version number field tells PIP to 
search for all versions of the file. 

The asterisk (*) character in one or more fields of a file specification 
stands for all. This is also called a wildcard specification. PIP restricts 
the use of wildcards in the cases Hsted below. 

The following restrictions apply to PIP output file specifications: 

1 . Copying a single file 

2. Listing a directory 

3. When you copy several files, the output file specification must 
be *.*;* or default. 

4. The output specification, used with the Rename and Enter 
switches, can mix wildcards with specified fields. With either 
switch, PIP uses the equivalent field of the input field specifica- 
tion. 

In all cases where PIP permits wildcards in the output file specification, 
the wildcard UIC fonn [*,*] is used to indicate that the output UIC is 
the same as the input UIC. 

The following restrictions apply to wildcards on PIP functions with input 
files: 

1 . *.*;* means all versions of all files in the current UFD 

2. *.DAT;* means all versions of all files of file type DAT in the 
current UFD 

3. TEST.*;* means all versions and all types of files with the file 
name of TEST in the current UFD 

4. *.* means the most recent version of all files in the current 
UFD 

5. *.DAT means the most recent version of all files of file type 
.DAT in the current UFD 

6. TEST.* means the most recent version of all file types for files 
named TEST in the current UFD 

7. TEST.DAT means the most recent version of TEST.DAT in 
the current UFD 

8. [*,*] means all UIC group, member combinations from 1 to 377 

9. [nl,*] means all UIC member numbers under group n 1 
10. [*,n2] means all group numbers for member n2 

ADD.*-,* refers to all versions of all types of the file named ADD in the 
current UFD. 
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4.2A Deleting Files 

Once you know what files are listed in your UFD, you can decide which 
files you want to delete. For example, to retain the highest numbered 
version of each of the files listed in Section 4.2.2, you would delete the 
following files: 

ADD.0BJ;1 
ADD.TSK;1 
ADD.TSK;2 

To delete these files with the PIP Delete switch, issue the following com- 
mand: 

> !"■ 1 P A D D . C) B J 5 :l. !- A D D . T S K ? 1 f A D D » T S K ? 2 / D E < C R > 



Note that the Delete switch requires either an explicit version number or 
a wildcard in the version field. However, the use of a wildcard is inappro- 
priate when your UFD includes files with the same name but other types 
and versions that you do not want to delete. In this instance, you must 
specify explicitly each file you want to delete. 

4.2.5 Purging Files 

When you want to eliminate all but the highest version of files, the PIP 
Purge switch is often more efficient than the Delete switch. The follow- 
ing Purge command has the same effect as the above Delete command: 

>PIP ADD.* /PU<CR> 



Purging does not affect any files in your UFD which only have one ver- 
sion. Note that the file specification for the Purge switch does not include 
a version field. After you issue the above command, you can issue the 
following command to see what files remain in your directory: 

>PIP /LI<CR> 



DIRECTOFl'Y 
lA-FEB-79 



DB0Ji;:30:i. y3:i.4:] 

09M.0 



ADD.0BvJJ2 
ADD ♦ hAP r 1 
ADD. STB y1. 
ADD.FTNf 1 
ADD.TSKJ^ 



4. 

3. 
:l, . 
29 . 



25 -JAN-79 
25 -JAN ■•••79 
25 -J AN ■79 
20^^JAN^^79 
25^^JAN-79 



:l. 4 ; 3 1 

1.4 2 32 

5 J 26 

2tOQ 

1.4 S 33 



TOTAL OF 39. /49. BLOCKS iCN 5 FXLES 
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As the listing shows, the UFD now contains only the highest version of 
each file. 

4.2.6 Selectively Deleting Files 

The PIP selective delete command prompts for your response before 
deleting a file. The responses allowed (<CR>, "Z,Y,N,Q, and G) cause the 
following action: 

Operation 

Deletes file and continues 
Deletes file and exits from PIP 
Saves file and continues 
Saves file and exits from PIP 
Saves file and continues 

Saves file and exits 

Saves file and returns to command 
mode. 

Saves file and exits from PIP 

Deletes this and all remaining can- 
didates for deletion, lists deleted 
files, and returns to PIP command 
mode. 

G "Z Deletes this and all remaining can- 

didates for deletion, Hsts deleted 
files, and returns to MCR. 

You can specify the Selective Delete switch (/SD) as follows: 

P:[p ADD** 5* /SD<CR> 

PIP responds: 

D i;;: i... i:;: r i;;: r- :i; i... i: d b :i. ; i:: 3 o 3 ^ :i. 2 3 a d d » r- r n j 1 1:: y / n / / c^ ::i ? y 
D E L E 1 E !=• :i: I... E. D B :i. U! 3 3 y :i. 2 ::i A i:i i:i <, o b j ? :i. i:: y / n / o / a :3 ? n 



Letter 


Terminator 


Y 


<CR> 


Y 


^Z 


N 


<CR> 


N 


^Z 


NULL 


<CR> 


(no response) 


NULL 


^Z 


Q 


<CR> 


Q 


^Z 


G 


<CR> 
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In response to your answers, PIP deletes ADD.FTN;! but does not delete 
ADD.OBJ;!. 

4.2.7 Copying Files 

Copying files is PIP's default function; that is, if you enter a legal PIP 
command line with no switches, PIP performs a copy operation. For 
example, the following command copies the file ADD. MAP from your 
UFD on SY: to your UFD on DK:. 

>F' I P DK J -ADD ♦ MAP<CR> 

The command includes the call to PIP, followed by a file specification in 
the form: 

outfile=infile 
in file 

The file to be copied 
outfile 

The new copy of the file 

When you omit the UFD, file name, file type, and/or version number in 
outfile, PIP defaults the UFD to your default UFD and the name, type, 
and version number of the file to the equivalent fields in the input file. 

Before you can copy a file to a directory on another volume, the directory 
must exist on that volume. In a multiuser protection system, your direc- 
tory on SY: is the only UFD automatically created for you; and in a non- 
multiuser system, no UFDs are automatically created. If the output 
volume specified in the above example does not contain a UFD corre- 
sponding to your UIC, PIP returns the message: 

PIP CANNOT f:i:nd directory file 

xxnt \.'.i;i>n\l 

4.2.8 Renaming Files 

The PIP Rename (RE) switch allows you to rename existing files. For 
example: 

>PIP ADDTWO ♦ * i *-«^ADD . * v * /RE<CR> 



This command tells PIP to change the names of all types and versions of 
the files named ADD to ADDTWO. Note that you must exphcitly specify 
either a number or a wildcard in both input and output version fields 
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when you use the Rename switch. The wildcards in the output file speci- 
fication indicate that the type and version of the renamed files remain the 
same. The directory now contains the following entries: 

niRECTORY DBO : 1130.1 » 31,4.1 

4-Auo-7e 3:03 

ADDTW0.0BJv2 2* 25- JAN ■••7? :l.4;3:l. 

AnniWO . MAP vl 4 ♦ 25- JAN-79 X 4 1 32 

A 1:1 i:iT W (3 , S T B n. 3 » 2 5 -• J A N ■ •■ 7 9 :l. 4 J 3 4 

A D m U) . F T N ? :l. :l. ♦ 2 Q ■- J A N -• 7 9 :i. 5 t 2 6 

AIIDTW0.TSKP3 29* C 

TOTAL OF 39»/49 4 BLOCKS IN 5 FILES 



Because the renaming function does not transfer data, you cannot specify 
a different device in the output file specification. If you want to rename a 
file as you copy it to another volume, enter the new name in the output 
specification of the COPY command hne. For example: 

>P 1 P UK t ADDT WD ♦ * ? *^::^ ADD . * ? *<CR> 



This command tells PIP to copy all types and versions of the file named 
ADD, which are stored in your UFD on SY:, to an equivalent UFD on 
the DK: disk, unit 0, where they will be named ADDTWO. 

4.3 THE QUEUE MANAGER 

System users often need to have copies of their files printed on the Hne 
printer. Consequently, the line printer is in heavy demand. An RSX-1 IM 
task called the Queue Manager provides for orderly use of the line printer. 
It does this by maintaining a queue of files to be printed according to 
their priority, time of request, and other factors, and by displaying infor- 
mation to let you know your file's place in the queue. 

4.3.1 Printing Files 

To send files to the line printer queue, you use the Queue Manager PRINT 
command, as follows: 

>PRINT ADD,MAP<CR> 

Note that you do not need to specify LP: or any other output file. This 
command asks the Queue Manager to enter ADD. MAP to the queue of 
files waiting to be printed. The system maintains the queue by file name 
and file identification number, copying each file or group of files to the 
line printer, usually on a first queued, first printed basis. The system also 
allows you to specify that files be printed after a certain time or date. 
Check the RSX-1 1 Utilities Manual for more information about the Queue 
Manager. 
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4.3.2 Listing Files in tlie Queue 

To determine whether a particular file is in the queue, waiting to be 
printed, type the following Queue Manager command: 

RUE /i..j:st<cr> 

The names of all the files waiting to be printed will be displayed on your 
terminal in response to this command in the following format: 

** PRINT QUEUES ** 
O F'RINT ^=> LPOJ 

tZOZ^ZOl MPREF (2000y3276) ACTIVE ON LPOt 

( DBO % v.. 303 1- 4 :J HREF ♦ DOC » 1 
e j riBO J Z 302 9 3 :l. ::i ADD « FTN y :l. 

( DK 1. { r: :l. 00 y :l. :] ADD3 . FTN P 2 

O Identifies the file currently being printed, its file identification 
number, name, and the printer. 

O Names of the files waiting in the queue to be printed. (These are 
listed in the order in which they will be printed.) 
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SAMPLE FORTRAN PROGRAM 



The following listing shows the development of the FORTRAN-IV pro- 
gram, ADD.FTN, and the manipulation of the resulting files. The listing 
illustrates how rapidly you can create numerous versions of the same file, 
and what to do to eliminate the old versions. 

What you type on your terminal is printed in red; what the computer 
prints on your terminal is printed. in black. 

>hei...<cf;;> 

ACCOUNT OR NAME? CaNRAD<CR> 
PASSWORD! <CR> 

R S X ■ ■•• 1 ;l. M B L. 26 M U I... T I ■■■■ U S E R S Y S J E M 

(300D MORNING 

:l 2- J AN •■•79 19137 LOGGEC ON TERM.TNAL TT32; 

12 --J AN ■•••7 9 

SYSTEM WILL BE DOWN TODAY FROM 13 J 00 -15 J 00 

>EDI ADDJ"TN^i::CR.> 
[CREATING NEW FILE!] 
XNFUT 

TYPE 1<CR> 

1 FORMAT <' ENTER TWO NUMBERS ••- M»N')-<CR.> 
APPE\EPP\CCEPT 2 .- K !- L''R<CR> 

ACCEPT 2?K-i-L^^:CR> 

2 FORMAT (222\22\I5)<CR> 
PR .TNT '''U 

TYPE 3!'K^{L^=::CR> 

3 FORMAT (' THE SUM IS '»:i:5)<CR> 
STOP-<CR> 

END^<CR> 
<CR> 

*ex;i:t 
i::exj;t::i 



A-l 



Sample Fortran Program 



>P:i:P TIJ™ADIUFTN<CR> 

TYPE :l. 

1 F'ORMAT <' ENTER TWO NUMBERS ■- MyN') 
ACCEPT 2»KyL 

2 FORMAT (21 5) 
TYPE 3H<tL 

3 FORMAT (' THE SUM IS 'i-IS) 
STOP 

END 

>E»X AnD«FTN<CR> 

t: 00008 l:i:nes read ]:n::i 
i:page :i,::i 

*LOCATE ENTER<CR> 

1. FORMAT ( ' ENTER TWO NUMBERS •••• M i- N ' ) 

>KCHANGE/ENTER/TYPE/<CR> 

:l. FORMAT (' TYPE TWO NUMBERS •• M^N') 

>i<NEXT<CR> 

*pr:i:nt<cr> 

ACCEPT 2yKyL 
>Kl..OCATE SUM<CR> 
3 FORMAT (' THE SUM IS 'ylS) 

*change/sum/result/<cr> 

3 format <' the result is ' ,1'5) 

*ldcate (2i5)<cr> 
c:*eob5k:i 

*TOP<CR> 
*<CR> 

TYPE :i, 

*EXIT<CR> 

i:exit:;i 



A-2 



Sample Fortran Program 



\my 



! PROMPT FOR INPUT 



>i;i:i:i:i: addj=tn<cr> 

[; 00008 LINES READ IN:!! 

IIPAGE :i:i 

*INSERT<CR> 

C THIS PROGRAM ADDS TWO NUMBERS<CR> 

<CR> 

*<ESC> 

<*BOB*> 

*<CR> 

C THIS PROGRAM ADDS TWO NUMBERS 

*I...OGATE NUMBERS<GR> 

1 FORMAT <' TYPE TWO NUMBERS ■• MvN') 

*ADD ! PROMPT FOR INPUT<CR> 

*PRINT<CR> 

1 FORMAT (' TYPE TWO NUMBERS - M k N ' ) 

>KLOCATE RESUI...T<GR> 

Z FORMAT ( '• THE RESULT IS 'vl'5) 

H<DELETE<CR> 

*<ESG> 

TYPE 3)-KfL 

* INSERT <CR> 

3 FORMAT (' THE SUM IS ' v 15 )! DISPLAY RESULT<CR> 

<CR> 

*TOP<GR> 

*<CR> 

C THIS PROGRAM ADDS TWO NUMBERS 

*RETYPE G ADD DISPLAYS THE SUM OF TWO NUMBERS<GR> 
>i«LIST<GR> 

C ADD DISPLAYS THE SUM OF TWO NUMBERS 
TYPE :l. 

1 FORMAT (' TYPE TWO NUMBERS •• MyN')! INPUT PROMPT 
ACCEPT 2 f K 1- L 

2 FORMAT <2IS) 
TYPE 3yK»L 

3 FORMAT (' THE SUM IS ' y 15) ! DISPLAY RESULT 
STOP 

END 
*EXIT<GR> 

i::exit::i 



>PIP ADD.*?* /LKCR:: 



DIRECTORY DBl J i;:303y 12::i 
6~MAY"79 20 J 09 



ADD*FTNJ3 
ADD.FTNP2 
ADDJ-TNJI 



I. 



06-MAY-79 20 {08 
06-MAY-79 20;07 
06-MAY-79 ;19M7 



TOTAL OF 3«/9. BLOCKS IN 3. FILES 



A-3 



Sample Fortran Program 



>FOR Ai:iD:'==Am:i<CF?> 

.MAIN. 

>V'IP ADD.*)!* /LKCrO 



DIRECTORY DBl } tZOZ y :I,23 
A-MAY--79 20t:l.0 



ADD.FTNPl 
ADri,FTNJ2 
ADl'i.FTNJrS 
AEiD.fJBjn. 



:l. 

1. 
1. 



06-MAY-79 :l.9t47 

06-MAY-79 20 J 07 

06-MAY-79 20108 

06- "MAY ••■•7 9 20S09 



TOTAL OF 'O./20. BLOCKS IN 4. FILES 



>FOR » ADD/ ■■■SP=-^ABB<CR> 

.MAIN. 

>PIP ADD.* 5* /LI<CR> 



D I RECTORY DB I X I ZOZ y :l. 2 ."J 
<f>"MAY-79 20 J 10 



ADD.FTNyl 
ADD.FTNv2 
ADD.FTN!I3 
ADD. OB J n. 
ADD.LST?! 



:l. . 
.1. . 
1. 



OA-MAY- 
06-MAY-- 
06-MAY • 
OA-MAY- 
OA-MAY" 



79 
79 
79 
79 
79 



:l.9J47 
20 J 07 
20? 08 
20 J 09 
20l:U> 



TOTAL OF 7./2!!5. BLOCKS IN 5. FILES 



>FOR »ADD^==ADD-=::CR> 

.MAIN. 

>PIP ADD.*?* /LI-::CR> 



DIRECTORY DBl X UM)Z* 121 
A -MAY "79 20::U) 



ADD.FTN?;!. 
ADD.FTNP2 
ADD.FTN!!3 
ADD. OBJ vl 
ADD.LBTJl 
ADD.LSTy2 



1. 
1. 



OA" 


"MAY" 


"79 


:l.9M7 


OA" 


"MAY" 


"79 


20t07 


OA" 


"MAY" 


"79 


20103 


OA" 


"MAY" 


"79 


20 JO? 


OA" 


"MAY" 


"79 


20t:l.0 


OA" 


"MAY- 


"79 


20J:l.2 



TOTAL OF 9. 730. BLOCKS IN A. FILES 



A-4 



>FOR ADD f ADD/-SP=ADD<CR> 

♦MAIN* 

>PIP ADD**?* /L.l<CR> 



DXRE CTORY DB:1. 1 1::^03 y 1.2:3 
A-MAY-79 20t:l.2 



Sample Fortran Program 



ADD , 


FTNS:l. 


ADD, 


FTN52 


ADD < 


FTNJ3 


ADD< 


OBJn. 


ADD , 


LSTM. 


ADD , 


LSI? 2 


ADD, 


0BJ?2 


ADD, 


LSTJ3 



()6-MAY-79 
06-MAY-79 
06-MAY "79 
OA-MAY-79 
06 "MAY- 79 
06 -MAY "79 
06 "MAY -79 
06 "MAY -79 



:19J47 
20 J 07 

20 toe 

20S09 
20 UO 
20 M. 2 
20;:l.2 
20 M. 2 



TOTAI... OF .1.3«/40. BLOCKS IN 8» FILES 



. FOR ADD » ADD===ADD<CR> 

♦MAIN* 

>PIP ADD**?* /LI<CR> 



DIRECTORY DB:I. n:;303y :i,2:3 
6-MAY-79 20J;l.5 



ADD»FTNn. 
ADD.FTNJ2 
ADD.FTNy3 
ADD* OBJ n. 
ADD ♦ LSI m 
ADD ♦LSI 5 2 
ADD ♦OBJ? 2 
ADD*LST?3 
ADD ♦OBJ? 3 
ADD ♦LSI? 4 



:i. ♦ 
!♦ 
!♦ 



06- 


•MAY- 


■79 


.1.9 M7 


06- 


•MAY- 


•79 


20? 07 


06- 


-MAY- 


-79 


20 J 03 


06- 


-MAY- 


■79 


20M)9 


06- 


-MAY- 


•79 


2on.o 


06- 


"MAY- 


•79 


20S:l.2 


06- 


-MAY- 


-79 


20 n. 2 


06- 


"MAY- 


-79 


20 n. 2 


06' 


"MAY- 


■■79 


20t:l.3 


06' 


"MAY- 


•79 


20 n. 3 



TOTAL OF 1,7. 750 ♦ BLOCKS IN :I.O* FILES 
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Sample Fortran Program 



>TKB ADD===ADD<CR> 

TKB *d:i:ag*-:i.3 



UNDEFINED SYMBOLS SEGMENT ADD 



ad:i;$mm 

EOL* 

:i:co$ 
:i:fr$ 

IFW* 

:i:sN$ 

I...SN$ 
MO.T$MM 
RELf 
SIP* 

Tu:i:$ 
iiiOTi: 

*OTS"v'A 



>pip add«*p* /i...:i:<cr> 



DIRECTORY DBl : i:;303 v :i.2::i 

6""MAY-79 20X16 



ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 



.FTNyl 
.FTN5 2 

♦ FTNii3 
.OBJn. 

J„ST?:l. 
♦LSTP2 
.0BJy2 
♦LST?3 

♦ OBJ J 3 
J...STP4 

♦ TSKJl. 



1* 



2* 
4. 



C 



06- 


•MAY 


-79 


:L9S47 


06- 


•MAY 


•79 


20 J 07 


06- 


•MAY 


•79 


20? 03 


06- 


•MAY 


•••79 


20 5 09 


06- 


•MAY 


■••79 


20? 10 


06- 


•MAY 


-79 


20?:l.2 


06- 


•MAY 


-79 


20?:l.2 


OA' 


•MAY 


-79 


2o;:i.2 


06' 


•MAY 


-79 


20?:l.3 


06- 


•MAY 


"79 


20? .1.3 


06- 


•MAY 


"69 


20?:l^4 



TOTAL OF 21. /54* BLOCKS IN 11* FILES 
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> T K JB y A n D / ■■ • 8 1--' ■■■■■■' A D D ? L B t C. 1 v 1 1 F Q R C) 1 S / 1... B < C R : 

>p:i:p ADru*?* /l:i:<cr> 



h I RECTORY DB :n i: 303 y 1 2 : 
A-MAY-79 20{:l.e 



Sample Fortran Program 



ADD* 
ADD ♦ 
ADD . 
ADD , 
ADD* 
ADD . 
ADD ♦ 
ADD ♦ 
ADD, 
ADD, 
ADD. 
ADD, 



FTNn. 
l""INil2 
FTNy3 
OBJn. 
LSI 5 1 
LSI 5 2 
OB J 5 2 
LSI 5 3 
0BJP3 
I... ST!) 4 
TSKi):l. 
MAP?:l. 



-4, 

:l.4. 



06-MAY-79 
06-MAY-79 
06 -MAY ••■■79 
06-MAY- 



06- 
06- 



MAY^ 
•MAY- 



06 •MAY •-79 



79 
79 
79 

,> 



06^ 
06- 
06^ 
06- 
06^ 



-MAY^ 
•MAY- 
•MAY^ 
•MAY^ 
•MAY^ 



•79 
•79 
•79 
•69 
•79 



:l.9J47 
20? 07 
20 SOB 
20? 09 
20?:L0 
20?;l.2 
20t:l2 
20 J 12 
20 J 13 
20? 13 
20? 14 
20? 14 



TOTAL OF 3;;5,/69, BLOCKS IH 12, FILES 



> "f K B y A D D y A D D -:= A III D y I... B ? L 1 y 1 ::i F" 1'^ If 8 / 1... B < C R : 
>P]:P ADD,*?* /L1'<CR> 



D I REcror;: Y DB 1 ? c: 3003 y 1 2 ::i 

6-MAY-79 20? 20 



ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 
ADD 



,FTNyl 
♦FTNy2 
,FTNy3 
,OBJf 1 
.LSTvl 
,LSTy2 
,0BJy2 
,LSTy3 
*0BJy3 
.LSTy4 
,TSKP1 
,MAPyl 
. MAP 5 2 
, STB PI 



1, 



1, 



2, 

2, 

2* 

4. 

14. 

14. 

4, 



06 -MAY -79 
06-MAY-79 
06 -MAY- 79 
06 -MAY -7 9 
06-MAY -79 
06 -MAY -79 
06-MAY -79 
06-MAY-79 
06-MAY-79 
06-MAY -79 
06-MAY-69 
06-MAY-79 
06-MAY-79 
06-MAY-79 



19? 47 
20? 07 
20? 03 
20? 09 
20? 10 
20? 12 
20? 12 
20? 12 
20? 13 
20? 13 
20? 14 
20? 14 
20? 15 
20? 12 



TOTAL OF 53 ♦/89. BLOCKS IH 14. FILES 



A-7 



Sample Fortran Program 



>TKB ADD » ADD v ADD-ADD v I...D Xtlfl ::IF0R0TS/LB<CR:: 
>P.TP ADD,*r* /LI<CR> 



DIRECTORY 


DBl 


:i::303» 


:i2::i 


A-MAY-79 


20 1 


:i.3 




ADD* FIN ?1 






:i. * 


ADDtFTNP2 






1* 


ADDJ-TNy3 






:l. * 


ADD* OBJ n. 






2* 


ADD J...ST?1 






2* 


ADDJ...RTi!2 






2* 


ADD«0BJP2 






2* 


ADD,LBTv3 






2* 


ADD* OBJ (13 






2* 


ADD * LSI P 4 






2* 


ADD*TSKy:l. 






4* 


ADD*HAPP:l. 






14 ♦ 


ADD * MAP V 2 






14* 


ADD*STB?:l. 






4* 


ADD*TSK?2 






33* 


ADD * MAP P 3. 






14* 


ADD * STB P 2 






4* 


TOTAL OF : 


1.04* 


/:i.42* 


BLOCKS 1 



c 



c 



06 -MAY -79 
06 -MAY -7 9 
06 -MAY -79 
06-MAY-79 
06~MAY™79 
06-MAY-79 
06-MAY~79 
06 -MAY -79 
06 -MAY -79 
06 -MAY -79 
06 -MAY -69 
06 -MAY -79 
06-MAY-79 
06 -MAY -79 
06 -MAY -79 
06 -MAY -79 
06-MAY-79 



19t47 
20 J 07 
20 SOB 
20t09 
20 J 10 
20 J 12 
20 J 12 
20: 
20: 
20: 
20 J 14 

2 on. 4 

20? 15 
20S12 
20 J 13 
20 5 15 
20 J 13 



12 

13 

1 3 



IH 17* FILES 



>PIP ADD.* /PU<CR> 
>PIP ADD**P* /LI<CR> 



D :i: RECTORY DB 1 J 1 303 c 1 2 1 
6 -MAY -79 20? 17 



ADD*FTNP3 


1. 


ADD.0BJP3 


2* 


AnD*LSTP4 


2* 


ADD*TSK?2 


33* 


ADD ♦ MAP P 3 


14* 


ADD* STB? 2 


4* 


TOTAL OF 56*/6B* 


BLOCKS IN 



06-MAY-79 
06 -MAY -79 
06 -MAY -79 
06-MAY-79 
06-MAY-79 



20 1 03 
20 M 3 
20? 13 
20? 15 
20? 15 
20? 13 



FILES 



A-8 



•PIP ADL'U*?* /TR<CR> 
■PIP Alli:i**y* /L.I<CR> 



DIRECTORY DB:I. n: 303 y 12:1 
6-MAY-79 20? 2:1. 



Sample Fortran Program 



Ai;iIiJ"TNJ3 
ADD. OBJ? 3 
ADDa..ST?4 
ADD,TSK!I2 
ADD* MAP? 3 
ADD. STB? 2 



2* 

2* 

33. 

:l.4. 

4. 



C 



06- 


■MAY- 


■79 


20 J 08 


06- 


•MAY- 


■79 


20 n. 3 


06- 


•MAY- 


•■79 


20513 


06" 


•MAY- 


■79 


20 M. 5 


06" 


■MAY- 


■79 


20? 15 


06" 


-MAY- 


-79 


20S13 



TOTAL OF 56. /56. BLOCKS IN 6. FILES 

Note that the last steF reduced the number of blocks 
allocated to the 6 files in the directory. 

>RUN ADD<CR> 

TYPE TWO NUMBERS •■ M^N 

ei'9^':;CR> 

THE SUM IS 17 

TT32; STOP 



>RUN ADD^:::CR> 

TYPE TWO NUMBERS ••■■ 

43»54<CR> 

THE SUM IS 97 

TT32J STOP 



Ms'N 



>iRUN ADD<CR> 

TYPE TWO NUMBERS 

99S!'2^=::CR> 

THE SUM IS 1001 

TT32J STOP 



MyN 



A-9 



.^^^ 



INDEX 



ADD.FTN, 

creation of, 2-2, 2-3 
editing of, 2-4, 2-8 
Assembly process, 2-1 

B 

Bell character, 1-6 
Blocks, 

allocated, 4-5 

total, 4-5 

used, 4-5 



EDI commands (Cont.) 
KILL command, 2-4 
LIST command, 2-7, 2-9 
LOCATE command, 2-5, 2-6, 2-8 
NEXT command, 2-5, 2-6 
PRINT command, 2-5, 2-6 
RETYPE command, 2-7, 2-9 
TOP command, 2-5, 2-6, 2-9 
TYPE command, 2-7 

EDT, and CRT terminals, 2-2 

Error message formats, 1-12 

Escape < ESC >, 1-8 



Carriage return < CR >, 1-4, 1-8 
Code, 

binary, 2-1 

machine readable, 2-1 1 
Communication, 

interactive, 1-1 

system to hardware, 1-1 

terminal to system, 1-1 
Compile, 2-1, 2-11 
Compiler defaults, 

file type, 2-1 1 

object file, 2-1 1 

source file, 2-1 1 

switches, 2-12 
Compiler, FORTRAN-IV, 2-1 1 

listing file, 2-12 

omitting output files, 2- 1 3 

storage map, 2-12 

switches, 2-12 
Computer Language, 2-1 
Computer Languages, 2-1 

Assemblers, 2-1 

COBOL, 2-1 

Compilers, 2-1 

FORTRAN-IV, 1-9 

Syntax, 2-1 



EDI, 2-1 

EDI commands, 
ADD command, 2-7 
BOTTOM command, 2-5 
CHANGE command, 2-5, 2-6 

< CR > command, 2-5, 2-6 
DELETE command, 2-7, 2-8 

< ESC > command, 2-7, 2-8 
EXIT command, 2-4, 2-7, 2-9 
INPUT command, 2-3 
INSERT command, 2-7, 2-8, 2- 



File, 2-1 

File specification, 

compiler input, 2-12 

compiler output, 2-12 

device, 3-1 

file name, 3-1,4-11 

file type, 3- 1 

file version, 3-1, 4-11 

RSX-llM, 3-1 

Task Builder input defaults, 2-1 5 

UFD, 3-1 

UIC, 3-1 

Task Builder output defaults, 2-15 
File type, 

BAS, 2-2 

CBL, 2-2 

F4P, 2-2 

FTN, 2-2 

MAC, 2-2 

standard, 2-12 
File, 

contiguous, 4-5 

creation of, 4-1 

explicit deletion of, 4-1 

locked, 4-5 

noncontiguous, 4-5 

other directories and, 3-4 
FORTRAN-IV compiler, 2-1 1 

command line specification, 2-1 1 

defaults, 2-11 

Object Time System Library, 2-15 
Function keys, use of, 1-3, 1-4 



I 



Interactive program, 2-2, 2-17 



Language translator, 2-1 
LB:, 2-15 



Index- 1 



INDEX 



Line Printer, 

priority, 4-1 1 

timing, 4- 1 1 
Line Text Editor (EDI), 

Creating new file, 2-2 

Editing existing file, 2-4 

Edit Mode, 2-4 

File version numbers, 2-7 

File names, 2-2 

File specifier, 2-2 

File type, 2-2 

Input Mode, 2-3 

Invoking, 2-2 
Linking, 2-1, 2-14 
Listing file, 

displayed on terminal, 2-13 

without object file, 2-13 
Loading, 2-14 
Logging on system, 1-10 

other user on system, 1-10 

short form, 1-10 

suppressing messages, 1-10, 1-11 

system messages, 1-10 
LP:, 3-3 

M 

Monitor Console Routine (MCR), 1-5, 1-6 

command line, 1-6, 1-7 

default prompt, 1-8, 1-10 

error messages, 1-12 

expUcit prompt, 1-6, 1-8 

implicit prompt, 1-5, 1-8 

keyword, 1-7 

parameter, 1-7 

terminator, 1-7 
MCR ABORT command, 1-7 
MCR ALLOCATE command, 4-1 
MCR DISMOUNT command, 1-7 
MCR HELLO command, 1-7, 1-8, 1-9, 1-10 
MCR HELP command, 1-6, 1-8 
MCR MOUNT command, 4-1 
MCR RUN command, 2-13, 2-16 

executing task, 2-16 

loading task image, 2-16 

locating task, 2-16 
MCR SET command, 2-1, 3-4 
MCR UFD command, 1-7, 4-1 
Multiuser protection system, 1-8, 3-4 

logging on, 1-8 



Object module, 2-1, 2-14 

creation of, 2-11 
Operating System, 

communicating with hardware, 1-1 

function of, 1-1 

MCR and, 1-5 



Password, 1-9 

acquiring, 1-10 

echo, 1-9 
Physical device, 3-2 
Peripheral Interchange Program (PIP), 4-1 

blocks allocated, 4-6 

command line defaults, 4-3 

file identification numbers and, 4-6 

file protection code, 4-6 

invocation of, 4-2 

multiple line format, 4-2, 4-3 

revision date, 4-6 

single line format, 4-2 

switches, 4-1 

wildcard restrictions, 4-7 
PIP functions, 

copying files, 4- 1 , 4-20 

deleting files, 4-8 

displaying brief UFDs, 4-5 

displaying files, 4-3 

displaying full UFDs, 4-6 

displaying UFDs, 4-4 

purging files, 4-8 

renaming files, 4-10 

selectively deleting files, 4-8 
Pseudo devices, 2-15, 3-2 



Queue Managers, 2- 1 2 

Queue Manager, 4-1,4-11,4-12 

hsting command, 4-12 

Print command, 4-1 1 



Return < RET>, 1-4 
RSX-1 IM Tasks, exit from, 1-6 
RSX-llM Utilities, 4-1 
Rubout, 1-4 



N 

Nonmultiuser protection system, 1-8 
Nonresident compiler, 

installation of, 2-13 

removal of, 2-14 



SLP, 2-1,2-2 

Source file, 2-1 

Source File, Creating, 2-1 

Languages, 2-1 
Source Language Input Program, 2-1 
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INDEX 



Spooling, 

automatic of listing file, 2-12 
SY:, 3-2, 3-3 

Symbols, resolution of, 2-12 
System disk (SY:), 3-4 

default, 3-2 

files stored on, 2-13 

multiuser protection, 2-13 

nonmultiuser protection, 2-13 
System message file, 1-10 
System message file, required messages, 1-10 



Tab, 1-4 

Task Builder, 2-14 

full command format, 2-14 
global symbol definitions, 2-14 
LB switch, 2-15 
MAPfiletype, 2-12, 2-16 
multiline command format, 2- 1 5 
OBJ file type, 2-14 
omitting input files, 2-1 5 
omitting output files, 2- 1 5 
output files, 

memory allocation file, 2-13 
symbol definition file, 2-13 
task image file, 2-13 
oversize command line, 2-15 
resolution of symbols, 2- 1 2 
short command format, 2-15 
STB file type, 2-12 
switches and options, 2-16 
TSK file type, 2-12 
Task image file, 2-1, 2-14 

Task prompt, 

DIGITAL supplied software, 1-8 
user-written software, 1-8 

Terminal, 

CTRL/O, continues output, 1 -5 
CTRL/Q, suppresses output, 1-5 
CTRL/0, suppresses output, 1-5, 1-6 
CTRL/S, continues output, 1-5, 1-6 
Cathode Ray Tube (CRT), 1-1 
control keys, 1-3 



Terminal (Cont.) 

function keys, 1-3 

hardcopy, 1-1 

initial default values, 1-9 

input from, 1-6 

keyboard, 1-3 

LA36, 1-1 

local/remote switch, 1-8 

state of, 1-8 

suppressing output, 1-5 

system access through, 1-9 

using the, 1-1 

VTIOO, 1-2 

VT 100 keyboard, 1-3 

VT52, 1-2 

VT52 keyboard, 1-3 
Text file, 2-1 
TI:, 1-8, 3-3 
Typeahead buffer, 1-6 

u 

UFD, 

changing, 3-4 

default, 3-4, 4-19 

nonmultiuser protection, 3-4 
UIC, 1-9, 3-4 

display of, 3-4 

login, 3-4 

special log-on formats, 1-10, 1-11 
UIC/UFD, difference between, 3-4 
User File Directory (UFD), 1-9, 3-4 
User Identification Code (UIC), 1-9, 

command formats, 1-1 1 

slash formats, 1-11 
User Logon Text File, 1-10 



Volume, 2-1 

Volume unit number, 3-1 



3-4 



w 



Wildcard, 4-7 
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READER'S COMMENTS 



NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company's discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 



Did you find this manual understandable, usable, and well-organized? Please make suggestions for improvement. 



Did you find errors in this manual? If so, specify the error and the page number. 



Please indicate the type of user/ reader that you most nearly represent. 

D Assembly language programmer 

n Higher-level language programmer 

D Occasional programmer (experienced) 

D User with little programming experience 

D Student programmer 

D Other (please specify) 



Name _____ Date . 

Organization 

Street . 



City — State . — Zip Code . 

or 
Country 



— — — Do Not Tear - Fold Here and Tape 



mmm 



No Postage 

Necessary 

if Mailed in the 

United States 



BUSINESS REPLY MAIL 

FIRST CLASS PERMIT N0.33 MAYNARD MASS. 



POSTAGE WILL BE PAID BY ADDRESSEE 



RT/C SOFTWARE PUBLICATIONS TW/A14 
DIGITAL EQUIPMENT CORPORATION 
1925 ANDOVER STREET 
TEWKSBURY, MASSACHUSETTS 01876 




— Do Not Tear - Fold Here 



s 



T3 
ID 

o 

a 

e 
o 






RSX-1 1 M 

Mini-Index 

Order No. AA-H262A-TC 



To order additional copies of this document, contact the Software Distribution 
Center, Digital Equipment Corporation, Maynard, Massachusetts 01754 



digital equipment corporation « maynard, massachusetts 



First Printing, May 1979 

The information in this document is subject to change without notice and should not be construed as a 
commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility 
for any errors that may appear in this document. 

The software described in this document is furnished under a license and may only be used or copied in 
accordance with the terms of such license. 

No responsibility is assumed for the use or reliability of software on equipment that is not supplied by 
DIGITAL or its affiliated companies. 



Copyright (c) 1979 by Digital Equipment Corporation 



The postage-prepaid READER'S COMMENTS form on the last page of this document requests the user's 
critical evaluation to assist us in preparing future documentation. 

The following are trademarks of Digital Equipment Corporation: 



DIGITAL 


DECsystem-10 


MASSBUS 


DEC 


DECtape 


OMNIBUS 


PDF 


DIBOL 


OS/8 


DECUS 


EDUSYSTEM 


PHA 


UNIBUS 


FLIP CHIP 


RSTS 


COMPUTER LABS 


FOCAL 


RSX 


COMTEX 


INDAC 


TYPESET-8 


DDT 


LAB-8 


TYPESET-11 


DECCOMM 


DECSYSTEM-20 


TMS-11 


ASSIST-11 


RTS-8 


ITPS-10 


VAX 


VMS 


SBI 


DECnet 


IAS 


PDT 


DATATRIEVE 


TRAX 





INTRODUCTION 

This manual is a brief index to the RSX-llM documentation set. It indicates where in the set informa- 
tion on a general topic can be found. A more detailed master index is being published as a post-release 
document. Neither index, however, is intended to replace the indexes found in the individual RSX- 
llM manuals. 

An acronym printed in itahc capital letters follows each entry in this index, and represents the name of 
the manual in which the information can be found. Chapter and section number references follow the 
acronym. Some entries are followed only by the chapter number(s), for example: 

PIP (Peripheral Interchange Program), UTL 4 

This entry indicates that PIP is discussed throughout chapter 4 of the utilities manual. 

Following is a Ust of the acronyms with the corresponding manual titles. (The RSX-llM/RSX-llS 
Documentation Directory lists the order numbers for these manuals.) 

BEG — RSX-llM Beginner's Guide 

CDA — RSX-llM/M-PLUS Crash Dump Analyzer Reference Manual 

DEV — RSX-llM/M-PLUS Guide to Program Development 

DRV — RSX-llM/M-PLUS I/O Drivers Reference Manual 

ERL — RSX-llM/M-PLUS Error Logging Reference Manual 

EXE — RSX-llM/M-PLUS Executive Reference Manual 

GEN — RSX-llM System Generation and Management Guide 

INT — Introduction to RSX-llM 

lOP — IAS/RSX-11 I/O Operations Reference Manual 

MAC - IAS/RSX-11 MACRO-11 Reference Manual 

MCR — RSX-llM/M-PLUS MCR Operations Reference Manual 

ODT — IAS/RSX-11 ODT Reference Manual 

SLR — IAS/RSX-11 System Library Routines Reference Manual 

TKB — RSX-llM/M-PLUS Task Builder Manual 

UMD — RSX-llM/M-PLUS User Mode Diagnostics Reference Manual 

UTL — RSX-11 Utilities Manual 

WRT — RSX-llM Guide to Writing an I/O Driver 
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Absolute addressing mode, MAC 5.10 
Accessing files, lOP 1.1, 2.5 
Account file (ACNT) entries, 

maintaining, MCR 2.3 
Account file maintenance program, see ACNT 
ACNT (account file maintenance program), 

MCR 2.3 
Addressing, 
branch instruction, 

in MACRO-11, MAC 5.14 
in supervisor mode, EXE 3.2 
locations in a task image file, UTL 19.3 
modes, 
MACRO-11, MAC 5 
absolute, MAC 5.10 
autodecrement, MAC 5.5 
autodecrement deferred, MAC 5.6 
autoincrement, MAC 5.3 
autoincrement deferred, MAC 5.4 
immediate, MAC 5.9 
index, MAC 5.7 
index deferred, MAC 5.8 
register, MAC 5.1 
register deferred, MAC 5.2 
relative, AL4C5.11 
relative deferred, MAC 5.12 
Address mapping, EXE 3.1 
Address space, 
logical, EXE 3.1 

extended, INT 3.3 
virtual, EXE 3.1 
Analog- to-digital converter driver, DRV 14 
ANSI magnetic tapes, lOP G 
Appending files, UTL 4.2 
Assembler, see MACRO-11 
Assembly language, see MACRO-11 
AST (Asynchronous System Trap), DRV 1.5, 
EXE 2.3, INT 3.3 
service routine, lOP 2.8 
Asterisk, 
convention in MCR, see Wildcards 
EDT prompt, UTL 2.1 
Asynchronous System Trap, see AST 
AT. (MCR indirect file processor), INT 4.1, 

MCR 5.2, 5.6 
Audit trail, 

SLP, UTL 17, 17.4 
Autodecrement addressing mode, MAC 5.5 



Autodecrement deferred addressing mode, 

MAC 5.6 
Autoincrement addressing mode, MAC 5.3 
Autoincrement deferred addressing mode, 

MAC 5.4 



B 



Back-up and Restore Utility, see BRU 
BAD (Bad Block Locator Utility), UTL 9 
Bad Block Locator Utility, see BAD 
Bad blocks, 
information on, 

with DSC, UTL 11.5 
locating, UTL 9.4 
BASIC-11. /Arr5.2 
BASIC-PLUS-2, INT 5.2 
Block I/O operations, lOP 1.4 
BRU (Back-Up and Restore Utility), UTL 10 
using, 
for data transfers, UTL 10.4 
to initialize disks, UTL 10.4 
with BAD, UTL 10.4 
with FMT, UTL 10.4 
Buffers, 

EDT text, UTL 2 
BYE command, MCR 2.3, 4.5 



Card reader driver, DR V 1 1 
Cassette driver, DRV 9 
CDA (Crash Dump Analyzer), 

analysis with, CDA 3.1, 3.2 

obtaining crash dumps with, CDA 1.2 

running, CDA 1.3 
Checkpointing, INT 3.2 
Checksum switch, UTL 17.1, 18.2 
CLI (Command Line Interpreter), 

command-line processing, lOP 6.2 

component of Queue Manager, UTL 7 
CMP (File Compare Program), UTL 16 
COBOL, INT 5.2 
Codes, 

directive, Z)i?VB.2 

I/O status, £)/?FB.l 

return, DiJV^ 1.10 
Command line, 

BAD, UTL 9.1 

BRU, UTL 10.3 
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Command line (Cont.), 

CDA, CDA 1.4 

CMP, UTL 16 

DMP, UTL 15.2 

DSC, UTL 11.4 

EDI, UTL 3.1 

EDT, UTL 2.1, 2.2 

FLX, UTL 5.1 

FMT, UTL 8.1 

format for utilities, UTL 1.1 

LBR, UTL 14.2 

MCR, 
examples of file name, MCR 3.2 
standard format for, MCR 3.2 

PAT, UTL 18.1 

PIP, UTL 4.1 

PRESRV, UTL 12.1 

PRI, C/TL 6.1, 6.2 

Queue Manager, UTL 6.4, 7.3 

SLP, UTL 17.1 

TKB, TKB 1.1 

VFY, f/TL 13.2 

ZAP, UTL 19.4 
Command Line Interpreter, see CLI 
Command-line processing, 

CSI— command string interpreter, TOP 6.2 

GCML— get command line, lOP 6.1 
Commands, 

for utilities, 
summary of, UTL A 

MCR, see MCR commands 
Comparing files, UTL 16 

Compiler, 

FORTRAN IV, BEG 2.2 
Console output task, see COT 
Copying files, BEG 4.2 

DOS-11, UTL 5.2 

Files-11, UTL 4.2, 5.2 

RT-11, UTL 5.2 

CORAL-66, INT 5.2 

COT (Console Output Task), GEN C 

Crash Dump Analyzer, see CDA 

Crash dumps, 
analyzing, CDA 3.1, 3.2 
obtaining, CDA 1.2 

Creating source files, BEG 2.1 

editors for, UTL 2, 3, 17.3 
Creating UFDs, UTL 4.2 
CRF (Cross-Reference Processor), UTL D 
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Data conversion routines, SLR 4, 5 
Data formats, 

TKB input, TKB A 
Data structures, 

for I/O. WRT 2.3, 2.7 

for I/O drivers, WRT 4.1 

RDB (Region Definition Block), EXE 3.5 

TKB, TKB 2.3, 4.3 

WDB, (Window Definition Block), EXE 3.5 
Data transfers, 

with BRU, UTL 10.4 

with DSC, UTL 11.8 

with FLX, UTL 5 

with PIP, UTL 4.2 

DCB (Device Control Block), WRT 2.3, 4.1 
Debugging, 

on-line, ODT 1.2 

tasks, INT 5.5 

user-written I/O drivers, WRT 3.4 
DEC Standard Editor, see EDT 
DECtape, 

driver, DRV 6 

powerfail recovery for, DRV 1.11 
DECtape II driver, DRV 7 
Deleting files, BEG 4.2 

on system, UTL 4.2 

on volumes, UTL 5.2 
Despooling files, UTL 6.1, C 
Device (see also Devices), 

drive modification, ERL D 

error reports, ERL 4.2 

independence, INT 6.3 

null, MCR 2.2 
Device Control Block, see DCB 
Device interrupt vector, 

for I/O drivers, WRT 2.3, 4.1 
Devices (see also Device), 

file-structured, lOP 1.2 

independence of, INT 6.3 

logical, MCR 2.2 

peripheral, MCR 2.2 

physical, names for, DRV 1.7 

private, INT 4.3, MCR 2.3 

pseudo, MCR 2.2 
names for, DRV 1.7 

public, INT 4.3, MCR 2.3 

RSX-llM, Z)/JF1.3 

unowned, MCR 2.3 

verifying, UTL 9.3 
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Diagnostics, 
user-mode, 
error messages, UMD 2.5 
for disk drive compatibility, UMD 13 
for line printers, UMD 12 
for RFll fixed-head disks, UMD 4 
for RK05 cartridge disk and RK05F fixed 

disk, UMD 5 
for RK06 and RK07 cartridge disk, UMD 6 
for RP02, RPR02, RP03, UMD 7 
for RP04, RP05, RP06 pack disks, UMD 3 
for RS03 or RS04 fixedrhead disk, UMD 8 
for terminals, UMD 12 
for TUlO or TS03 magnetic tape, UMD 11 
for TU16 or TU45 magnetic tape, UMD 10 
for TU56 DECtape, UMD 9 
initiation of, UMD 2.4 
multidevice testing, UMD 2.6 
Directive Parameter Block, see DPB 
Directive codes, DRV B.2 
Directives, 
event-associated, EXE 6.1 
functions of system, INT 3.3 
identification codes for, EXE C 
informational, EXE 6.1 
intertask communications-related, EXE 6.1 
I/0-related, EXE 6.1 
macro, MAC 7 
MACRO-11, MAC 6 
MCR AT., MCR 5.2, 5.6 
memory management, EXE 3, 6.1 
parent/offspring tasking, EXE 6.1 
summary of, EXE A 
system, 
DIR$ macro, EXE 1.4 
error returns, EXE 1.3 
FORTRAN subroutines, EXE 1.5 
macro name conventions for, EXE 1.4 
processing of, EXE 1.2 
restrictions for nonprivileged tasks, 

EXE 1.7 
task states, EXE 1.6 
task execution control, EXE 6.1 
task status control, EXE 6.1 
trap-associated, EXE 6.1 
I3isks 
backing up, with BRU, UTL 10.4 
drivers for, DRV 5 
powerfail recovery for, DRV 1.11 
Disk Save and Compress Program, see DSC 
Disk Volume Formatter, see FMT 
Displaying files, BEG 4.2 
DMP (File Dump Utility), UTL 15 



DPB (Directive Parameter Block), DRV 1.6 

and I/O drivers, WRT 4.1 
Drivers, 
analog- to-digital converter, DRV 14 
card reader, DR V 1 1 
cassette, DR V 9 
DECtape, DiZV 6 
DECtape II, J9i?K 7 
disk, DRV 5 

graphics display, DR V 20 
industrial control subsystems, DRV 18 
I/O, 
executive services available to, 
conditional routines, WRT 5.2 
service calls, WRT 5.3 
system-state register convention, 
WRT 5.1 
function of, WRT 1.2 
loadable, WRT 1.1 
resident, WRT 1.1 
user-written, 
debugging, WRT 3.4 
inclusion of, 
data base and driver source in, 

WRT 6.2 
device description in, WRT 6.1 
special user buffers in, WRT 6.3 
loadable, WRT 3.3 
overview of, WRT 3.1 
rebuilding, WRT 3.4 
resident, WRT 3.2 
writing, 
data structures in, WRT 4.1 
INTSV$ macro and, WRT 4.2 
multicontroUer drivers, WRT 4.2 
K-series peripheral support routines, DR V 22 
laboratory peripheral accelerator, DRV 21 
laboratory peripheral systems, DRV 16 
line printer, DRV 10 
magnetic tape, DR V 8 
message-oriented communication, DRV 12 
null device, DEK 19 
paper tape reader/punch, DRV 17 
PCLll parallel communications link, 
DRV 13 

terminal, 
full-duplex, D/JK 2 
half-duplex, DEV 3 
virtual, £)i?V 4 

unibus switch, Z)iZV 23 

universal digital controller, DRV 15 
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DSC (Disk Save and Compress Program), 
initiating, 

on-line, UTL 11.2 

stand-alone, UTL 11.3 
operation, 

data transfers, UTL 11.8 
terminating, 

on-line, UTL 11.2 

stand-alone, UTL 11.3 
Dumps, 
file, with DMP, UTL 15 
system crash, 

analyzing, with CDA, CDA 3.1, 3.2 

obtaining, with CDA, CDA 1.2 
task, 

post mortem, INT 5.5, TKB 8.1 

snapshot, INT 5.5, TKB 8.2 
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EDI (Line Text Editor), BEG 2.1, INT 5.1, 

C/TL3 
Editing files, BEG 2.1 
with EDI, UTL 3 
with EDT, UTL 2 
with SLP, UTL 17 
EDT (DEC Standard Editor), UTL 2 
Editors, 
batch, 

SLP, UTL 17 
interactive, 
EDI, /A/^rs.l, UTLZ 
EDT, /iVT 5.1, [/rL2 
ERF (error logging shutdown task), ERL 3.4 
ERL (error logger task), ERL A.l 
Errlog (error logger), ERL 2.2, 3.1 
Error codes, executive, EXE B 
Error detection, 
by ODT, ODT 5.1, 5.2 

Error logging, INT 4.4 
ERF (shutdown task), ERL 3.4, 5.4 
ERL (error logger task), ERL A.l 
Errlog (error logger), 

files, ERL 2.2 

formats, ERL B 

messages, ERL 5.1 

running, ERL 3.1 
error log file, JE7.RL 1.2 
executive features of, ERL 2.1 
functions of, ERL 1.2 
information from, ERL 1.2 



Error Logging (Cont.), 
messages, ERL 5.1 
operating procedures, ERL 3 
options, ERL 1.2 
purposes of, ERL 1.2 
reports, 

device error, ERL 4.2 

device interrupt timeout, ERL 4.2 

formatting, £;itL 1.2 

generating, ERL 1.2, 4.1 

individual, ERL 4.2 

memory parity error, ERL 4.2 

summary, JBiJL 4.4 

unexpected trap or interrupts, ERL 4.2 
task interaction with, ERL 2.2 
Error messages, 
BAD, UTL 9.7 

BRU processing of, UTL 10.6 
CDA, CDA A 
CMP, UTL 16.3 
DMP, [7TL 15.4 
DSC, UTL 11.9 
EDI, J/TX 3.6 
EDT, UTL 2.6 
error logging, ERL 5.1 
FLX, C/TL 5.6 
FMT, UTL 8.5 
LBR, UTL 14.9 
MCR, fi£;G 1.3, MCR A 
ODT, 0£)T 5.1, 5.2 
PAT, UTL 18.3 
PIP, UTL 4.3 
PRESRV, Z/TL 12.5 
PRI and QUE, UTL 6.6 
Queue Manager, UTL 7.4 
SLP, UTL 17.5 
TKB, Ti^CB F 
TKTN, MCR A 
UMD, L^MD 2.5 
ZAP, UTL 19.7 
Error reports, see Error logging, reports 
Event flags, EXE 2.2, INT 3.3 

in I/O operations, /OP 2.8 
Events, 

significant, DRV 1.5, EXE 1.2, /ATT 3.3 
Executive, 
control, INT 3.2 
error codes, EXE B 
features for error logging, ERL 2.1 
services and I/O drivers, VFiJT" 2.4, 6 
Executive Debugging Tool, see XDT 
Executive directives, see Directives 
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FCS, INT 6.3, lOP 1 

library system generation options, lOP K 

resident library, 
building 4K, GEN G 

spooling from user-written tasks with, 
UTL 6.5 
FDB (File Descriptor Block), lOP 1.9, 2.2, A 

offsets, lOP 2.3 
File access, 

methods of, lOP 1.1 

optimizing, lOP 2.5 
File control routines, 

ASCII-to-binary UIC conversion, lOP 4.6 

default directory-string, lOP 4.2 

default file-protection word, lOP 4.4 

default UIC, lOP 4.3 

device control, lOP 4.16 

directory entry, lOP 4.8 

file deletion, lOP 4.15 

file extension, lOP 4.13 

filename block, lOP 4.7, 4.9 

file owner word, 10 P 4.5 

file pointer, lOP 4.10 

file truncation, I OP 4.14 

queue I/O function, lOP 4.11 

rename file, lOP 4.12 

File Control Services, see FCS 
File Descriptor Block, see FDB 
File despooling, UTL 6.1, C 
File directory, see UFD 
File dumping, UTL 15 
File Dump Utility, see DMP 
File-header block format, lOP F 
File labels, DSC, UTL 11.5 
File manipulation, INT 6.2 
Filename block, lOP B 
File ownership, INT 6.2, MCE 3.1 
File protection, INT 6.2 

access type, MCR 3.1 

assigning access rights, MCR 3.1 

user groups, MCR 3.1 

with PIP, UTL 4.2 
Files, 

copying, BEG 4.2, UTL 4.2 

creating, BEG 2.1 
with EDI, UTL 3 
with EDT, UTL 2 
with SLP, UTL 17 

correction, 
PAT, UTL 18.2 



Files (Cont.), 
deleting, BEG 4.2 
despooling, UTL 6.1, 6.4, 7,C 
device name, BEG 3.1 
displaying, BEG 4.2 
editing, BEG 2.1 

with EDI, f/TL 3 

with EDT, UTL 2 

with SLP, UTL 17 
indirect command, 

MCR, MCR 5 
library, UTL 14.5 
listing, in queue, BEG 4.3 
manipulating, /ATT 6.2 
merging, UTL 4.2 
printing, B^^G 4.3, UTL 4.2, 6, 7 
purging, BEG 4.2, f/TL 4.2 
renaming, BEG 4.2, t/TL 4.2 
spooling, UTL 4.2, 6.1, 6.2, 7,C 
task image, structure of, TKB B 
UFDs for, BEG 3.2 
validating (verifying) contents of, 

with PAT, UTL 18.2 

with SLP, UTL 17.1, 17.5 
Files-11, 
copying, files with PIP, UTL 4.2 
directories (UFDs) for files, INT 6.2, 

MCR 3.1 
ownership of files, INT 6.2, MCR 3.1 
protection for files, INT 6.2, MCR 3.1, 
C/TL 4.2 

access types, MCR 3.1 

assigning access rights, MCR 3.1 

user groups, MCR 3.1 
File specifications, INT 6.2 
creating, within user program, lOP 2.4 
dataset descriptor in, lOP 2.4 
default filename block in, lOP 2.4 
dynamic processing of, lOP 2.4 
for utilities, 

defaults for, UTL 1.1 

format of, UTL 1.1 
MCR, MCR 3.2 
TKB, TifB 1.7 
File specifiers, 

MCR, MCR 3.2 
File spooling, UTL 6.1, 6.2, 7 
File Storage Region, see FSR 
File-structured devices, 

data formats for, lOP 1.2 
File structures, 
disk and DECtape (Files-11), lOP 5.1 
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File structures (Cont.), 

in raagnetic tape file processing, lOP 5.2 

verifying, with VFY, UTL 13 
File Structure Verification Utility, see VFY 
File system, 

Files- 11, see Files- 11 

RSX-llM, /./VT6.1 
File Transfer Program, see FLX 
File transfers, 

with BRU, UTL 10.4 

with DSC, UTL 11.8 

with FLX, UTL 5 

with PIP, UTL 4.2 
File types, 

MCR standard, MCR 3.2 
FLX (File Transfer Program), UTL 5 

file transfers, 
command line for, UTL 5.1 

volumes, 
transferring files between, UTL 5.2 

FMT (Disk Volume Formatter), UTL 8 
Fork list, 

and I/O drivers, WRT 2.3 
Format, 

file header block, lOP F 

index file, lOP E 

QIQi macro format, DRV l.b 

TKB input data, TKB A 
Formats, 

CMP output file, UTL 16.2 

data, 
for file-structured devices, lOP 1.2 
Formatting, 

output, routines for, SLR 6 

volumes, 
with FLX, UTL 5 
with FMT, UTL 8 
FORTRAN IV, INT 5.2 

compiling, source file, BEG 2.2 

requesting a nonresident compiler, BEG 2.2 

sample program, BEG A 
FORTRAN IV-PLUS, INT 5.2 
FSR (File Storage Region), lOP 1.1 

initializing, lOP 2.6 

size of, lOP 2.7 



G 



Generating an RSX-llM system, see System 

generation 
Global symbols, TKB 2.1, 4.2 
Graphics display driver, DRV 20 



H 



HELLO command, BEG 1.2, MCR 2.3, 4.5 
HELP command, BEG 1.2, MCR 4.5 



Immediate addressing mode, MAC 5.9 
Index addressing mode, MAC 5.7 
Index deferred addressing mode, MAC 5.8 
Index file, 
format, lOP E 
bit map in, lOP E.3 
bootstrap block in, lOP E.l 
home block in, I OP E.2 
predefined file header blocks in, lOP E.4 
Indirect command files, 
MCR, INT 4.1, MCR 5.1 
AT. (indirect file processor), MCR 5.2 
default file type for, MCR 5.1 
example of, MCR 5.8 
initiating, MCR 5.1 
multilevel, MCR 5.5 
switches, MCR 5.4 
symbols, MCR 5.3 
task, MCR 5.1, TKB 1.5 
with utilities, UTL 1.4 
Industrical control subsystems drivers, 

DRV 18 
Initializing volumes, 

with FLX, UTL 5.2 
Install-run-remove tasks, MCR 4.2 
Interrupts, 

report on unexpected, ERL 4.2 
Invoking, 

RSX-11 utilities, UTL 1.1 
I/O, 
logical, Z)i?K 1.2 
physical, ZJiJF 1.2 
RSX-llM, DiiV 1.1 
virtual, £)i?V 1.2 
I/O completion, DRV 1.9 
I/O data structures, WRT 2.3 
interrelationships, WRT 2.7 
I/O drivers, see Drivers 
I/O executive services, WRT 2.4 
I/O exerciser, see lOX 
I/O function codes, DRV B.3 
I/O functions, 
standard, DJFJF 1.8 
summary of, DR V A 
I/O operations, 
block, lOP 1.4 
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I/O operations (Cont.), 

coordinating, lOP 2.8 
AST service routine, lOP 2.8 
event flags, lOP 2.8 
I/O status block, TOP 2.8 

physical, INT 6.4 

record, lOP 1.5 

task, INT 6.3 
I/O packet, 

and I/O drivers, WRT 2.3, 4.1 
I/O philosophy, WRT 2.1 
I/O programming standards, WTtT 2.5 
I/O queue, 

and I/O drivers, WRT 2.3 
I/O request, 

flow of, WRT 2.6 

issuing, DRV 1.5 
I/O status codes, DRV B.l 
I/O structure, VFi?T 2.2 
lOX (I/O exerciser), Gi^iV E 



K 



K-series peripheral support routines drivers, 
DRV 22 



Laboratory peripheral accelerator driver, 

DRV 21 
Laboratory peripheral systems driver, DRV 16 
Languages, 

BASIC-11, 7ArT5.2 

BASIC-PLUS-2, INT 5.2 

COBOL, INT 5.2 

CORAL-66, INT 5.2 

FORTRAN IV, INT 5.2 

FORTRAN IV-PLUS, INT 5.2 

supported, INT 2.2 
LBR (Librarian Utility Program), UTL 14 
Library, 

files, 
format of, UTL 14.5 

system, routines, see System library rou- 
tines 
Line printer driver, DRV 10 
Line Text Editor, see EDI 
Listing files, 

creating, BEG 2.2 

in queue, BEG 4.3 

with FLX, UTL 5.2 

with PIP, UTL 4.2 



Locations, manipulating, 

in a task image file, UTL 19.5, 19.6 
Logging off a terminal, MCR 2.3 
Logging on a terminal, MCR 2.3 
Logical address space, EXE 3.1 

extended, INT 3.3 
Logical I/O, £)i?V 1.2 
Logical unit number, see LUN 
Logical units, DRV 1.4 
LPP (Despool Prototype Task), 

as component of Queue Manager, UTL 7 
LUN (Logical Unit Number), DRV 1.4, 1.7 



M 



Macro 

QIO, format, Diiy 1.5 
MACRO-ll,/ArT5.2 
addressing, 

branch instruction, MAC 5.14 
addressing modes, 

absolute, MAC 5.10 

autodecrement, MAC 5.5 

autodecrement deferred, MAC 5.6 

autoincrement, MAC 5.3 

autoincrement deferred, MAC 5.4 

immediate, MAC 5.9 

index, MAC 5.7 

index deferred, MAC 5.8 

register, MAC 5.1 

register deferred, MAC 5.2 

relative, AL4C 5.11 

relative deferred, MAC 5.12 

summary of, MAC 5.13 
assembly and cross-reference listing, 

sample of, MAC I 
character set, MAC 3.1 
coding standard, 

sample of, MAC E 
command line format, MAC 8.1 
direct assignment statements for, MAC 3.3 
directives, 

conditional assembly, MAC 6.10 

data storage, MAC 6.3 

function, MAC 6.2 

listing control, MAC 6.1 

location counter control, MAC 6.5 

macro, MAC 7 

program boundaries, MAC 6.7 

program sectioning, MAC 6.8 

summary of, MAC B 

symbol control, MAC 6.9 

terminating, MAC 6.6 
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MACRO-lKCont.), 

error messages, MAC 8.4 

summary of diagnostic, MAC D 
expressions, MAC 3.9 
file specification format, MAC 8.3 
file specification switches, MAC 8.1 
numbers, MAC 3.7 
operating procedures, MAC 8 
overview of, MAC 1.1 
Permanent Symbol Table (PST), MAC C 
position-independent code, 

writing, MAC G 
radix and numeric control facilities, MAC 6.4 
relocation and linking, MAC 4 
source programs, MAC 2.2, 2.3 
programming standards and conventions 
for, MAC 2.1 
symbols, M/IC 3.2 
local, MAC 3.5 
register, MAC 3.4 
terms, AM C 3.8 
trap instructions, MAC 5.15 
virtual memory, 
allocating, MAC F 
Macro calls, 

file-processing, lOP 3.1-18 
Macros, 
arguments for, MAC 7.3 
calling, MAC 7.2 
defining, MAC 7.1 
I/0-related, DRV 1.7 
Magnetic tapes, 
ANSI standard, lOP G 
driver for, £>jf?7 8 
Maintenance, 

system, features of, INT 4.4 
Mapped systems, INT 3.1 
task relocation on, TKB 2.4 
TKB addressing on, TKB 2.2 
Mapping, 

addresses, EXE 3.1 
MCR, 
command line, MCR 3.2 
commands, BEG 1.2 
description of format and syntax, MCR 4.4 
format for, MCR 4.1 
issuing, MCR 4.1 
line terminators for, MCR 4.1 
nonprivileged, MCR 4.5 
parameters for, MCR 4.1 
privileged, MCR 4.6 
summary of, MCR 4.3 



MCR interface, INT 4.1, MCR 4.2 

command references to active tasks, 
MCR 4.2 

comments, MCR 4.2 

keywords, MCR 4.2 
Memory, 

organization of, INT 3.1 

parity error reports, ERL 4.2 
Memory dumps, TKB 8.1, 8.2 
Memory management, 

directives, EXE 3, 6.1 

dynamic, routines, SLR 7 

virtual, routines, SLR 8 
Merging files, UTL 4.2 
Message-oriented communication driver, 

DRV\2 
Messages, see Error Messages 
Mode, 

supervisor, 
addressing in, EXE 3.2 
Modes, 

for reading logical records, lOP 3.9, 3.10, 
3.11 

for writing logical records, lOP 3.12, 3.13, 
3.14 

MACRO-11 addressing, MAC 5 
Monitor Console Routine, see MCR 
Multicontroller I/O driVers, WRT 4.2 
Multiprogramming, MCR 1.3 

applications, MCR 3 



N 



Networks, INT 2.3 
Null device, MCR 2.2 
driver, £)i?F 19 



o 



Object Module Patch Utility, see PAT 

Object modules, 
creating, BEG 2.2 
linking with TKB, TKB 2.1 
updating, with PAT, UTL 18.2 

ODT (On-Line Debugging Tool), 
linking and initiating, ODT 4.3 
relationship to ZAP, UTL 19 

Offsets, 
FDB, lOP 2.3 

On-Line Debugging Tool, see ODT 

Operating procedures, 
error logging, ERL 3 
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Operating procedures (Cont.), 

MACR0-ll,MylC8 

ODT, ODT 4 
Operators, 

SLP, UTL 17.3 

ZAP arithmetic, UTL 19.4 
Output, 

formatting routines, SLR 6 
Overlay, TKB, 

building an, TKB 4.7 

data structures, TKB 4.3 

descriptor language, TKB 4.4 
summary of, TKB 4.5 

error handling, TKB 5.3 

loading methods, TKB 5.1, 5.2 

programs, TKB 4.6 

structures, TKB 4.1 

tree, TKB 4.2, 4.5 



Paper tape reader /punch driver, DRV 17 
Parent/offspring tasking, EXE 4.1, 4.2 
Parity error reports, ERL 4.2 
Parsing a UFD command line, 

example of, lOP 7.6 
Partitions, MCR 1.2 

PAT (Object Module Patch Utility), UTL 18 
Task Builder and, 
adding a subroutine to a module with, 

UTL 18.2 
overlaying lines in module with, UTL 18.2 
updating (patching) object modules with, 
UTL 18.2 
Patching, 
object modules (relocatable), with PAT, 

UTL 18.2 
task image files, with ZAP, UTL 19.5 
PCLll parallel communications link driver, 

DRV 13 
Peripheral Interchange Program, see PIP 
Permanent Symbol Table, see PST 
Physical 110, DRV 1.2 
operations, INT 6.4 
PIP (Peripheral Interchange Program), BEG 
4.1, INT 6.2, UTL 4 
command functions, UTL 4.2 
copying Files-11 files with, UTL 4.2 
Position-independent code, 

writing, MAC G 
Post mortem dumps, INT 5.5, TKB 8.1 
Powerfail recovery, 
for DECtape and disks, DRV 1.11 



Power failure restart, INT 4.4 
Preservation Utility, see PRESRV 
PRESRV (Preservation Utility), UTL 12 

operating procedures, UTL 12.2 
PRI and QUE (Print and Queue Manager), 
despooling files with, UTL 6.1 
Print command, UTL 6.1-3 

format, UTL 6.2 
Queue Manager, 
command format, UTL 6.4 
commands, 
nonprivileged user, UTL 6.4 
privileged user, UTL 7.3 
serial despooler with, UTL 6.1 
spooling, 
files with, UTL 6.1 
output from user-written tasks with, 
UTL 6.5 
PRINT command, 
format, UTL 6.2 
description of, UTL 6.3 
spooling output from user-written tasks 
with, UTL 6.5 
Printing files, BEG 4.3 
Print jobs, UTL 6.1 
attributes of, UTL 6.1 
identification, UTL 6.4 
queued by user tasks, UTL 6.5 
queue entries for, UTL 7 
Processor Status Word, see PSW 
Program development, INT 2.2 
cross-reference listing in, 

generating, DEV 3.5, 4.3 
debugging in, INT 5.5, DEV 5 
dumps in, INT 5.5, DEV 5.2, 5.3 
editing utilities for, INT 5.1 
environment, DEV 1 
DIGITAL-supplied system software, 

DEV 1.2 
hardware, DEV 1.3 
software tools, DEV 1.1 
errors, 
assembly, £)£F 3.1 
task building, DEV 4.4 

Fortran IV, procedures, DE V 7 
languages for, INT 5.2 
supported, INT 2.2 

process, DEV 1.4 
program libraries in, 

macro source, DEV 6.1 

object module, DEV 6.2 

program modules in, DE V 3 
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Program development (Cont.), 
source files in, 
creating from a skeleton file, DEV 2.2 
diagnostics, performing, DEV 3.1 
editing, Z)£;K 2.3 
MACRO-11, creating, DEV 2 
task building in, INT 5.3, DEV 4, TKB 3.1 
Programming languages, see Languages 
Program sections, TKB 2.1, 4.2 

virtual, TKB 3.4 
Prompts, 

MCR input, MCR 2.1 
Protecting files, see File protection 
PSE (error logging pre-formatter), ERL 

2.2, 3.2 
PSW (Processor Status Word), ODT A 
Purging files, BEG 4.2, UTL 4.2 



Q 



QIO macro format, DRV 1.5 
Queue Manager, BEG 4.3, INT 6.2 
RSX-llM V3.2, UTL 6, 7, GEN D 
command format, UTL 6.3, 7.4 
commands, 
nonprivileged, UTL 6.4 
privileged, UTL 7.3 
components of, C/TL 7 
installing, ?7TL 7.1 
reference example, UTL 7.2 



'fc^^-^ 



R 



RDB (Region Definition Block), EXE 3.5 
Record I/O operations, /Of 1.5 
Record Management Services, see RMS 
Region Definition Block, see RDB 
Regions, EXE 3.3 

dynamic, in TKB, TKB 3.3 

shared, in TKB, TKB 3.1 

Register addressing mode, MAC 5.1 
Register deferred addressing mode, MAC 5.2 
Register handling routines, SLR 2 
Reject transitions, 

example of using, lOP 7.6 
Relative addressing mode, MAC 5.11 
Relative deferred addressing mode, MAC 5.2 
Renaming files, BEG 4.2 

with PIP, UTL 4.2 
Reports, error logging, see Error logging, 

reports 
Restarting system, 

after power failure, INT 4.4 



Return codes, DRV 1.10 

RM Demo, GEN B 

RMS (Record Management Services), INT 6.3 

Round robin scheduling, INT 3.2 

Routines, 

file control, see File control routines 

system library, see System library routines 
RSX-llM, 

applications of, 
multiprogramming, INT 3 
real-time, INT 2.1, 3 

devices, £)/?V 1.3 

file system, INT 6.1 

introduction to, INT 1.1 

system generation, see System generation 
RSX-llS, 

introduction to, INT 1.2 



SCB (Status Control Block), 

and I/O drivers, WRT 2.3, 4.1 
Serial Despooler Task, UTL 6.1, C 
Shared Peripheral Operations On-Line, see 

Spool 
Shutting down system, MCR 2.4 
SHUTUP program, MCR 2.4 
Significant events, DRV 1.5, EXE 2.1, INT 3.2 
SLP (Source Language Input Program), 
UTL 17 

editing source files with, UTL 17.3 

processing, UTL 17.2 
Snapshot dumps, INT 5.5, TKB 8.2 
Source files, 

creating with SLP, UTL 17.3 

updating with SLP, UTL 17.3 
Source Language Input Program, see SLP 
Spool (Shared Peripherals Operation On-Line), 
UTL 6.1 
Spooling, 

from user-written tasks, UTL 6.5 

with PIP, UTL 4.2 

with PRI and QUE, UTL 6.1 

with PRINTS macro call, lOP 7.6 
SST (Synchronous System Trap), DRV 1.5, 

EXE 2.3, INT 3.3 
Status Control Block, see SCB 
Stop-bit synchronization, EXE 2.4 
Subexpressions, 

example of using, lOP 7.6 
Subpartitions, INT 3.1, MCR 1.2 
Supervisor mode, 

addressing in, EXE 3.2 
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Swapping, INT 3.2 
Switches, 

BAD, UTL 9.2, 9.5 

CDA, CDA 2.1, 2.2 

CMP, UTL 16.1 

DMP, UTL 15.3 

DSC, UTL 11.5, 11.7 

FLX, UTL 5.2 

FMT, UTL 8.4 

for utilities, summary of, UTL A 

LBR, UTL 14.4, 14.6 

MCR, MCR 5.4 

ODT, ODT 4.2 

PAT, UTL 18.1 

PIP, f/TL 4.1, 4.2 

PRESRV, UTL 12.3 

Print command, UTL 6.3 

Queue Manager, UTL 6.3 

SLP, f/TL 17.4 

TKB, TKB 6.1 
modifying defaults for, TKB D.2 

ZAP, UTL 19.2 
SYE (error logging report generator), ERL 3.3 
Symbol definition file, TKB 3.1 
Symbols, 

global, TKB 2.1, 4.2 

indirect command file, MCR 5.3 

reserved, TKB C 

substituting values for, INT 4.1 
Synchronous System Trap, see SST 
System, 

host, for TKB, TKB 7 

restarting, after power failure, INT 4.4 

shutting down, MCR 2.4 

target, for TKB, TKB 7 
System conventions, GEN F 
System directives, see Directives, system 
System generation, RSX-llM V3.2 

getting started, GEN 5 

installation verification, GEN 10 

system conventions, GEN F 

VMR, GEN 8 
System library routines, 

arithmetic routines, SLR 3.1, 3.2 

dynamic memory management routines, 
SLR 7.1-4 

input data conversion routines, SLR 4.1-3 

output data conversion routines, SLR 5.1-4 

output formatting routines, SLR 6.1-3 

register handling routines, SLR 2.1-4 

virtual memory management routines, 
SLR 8.1-5 



System maintenance, 
features of, INT 4.4 
System traps, INT 3.3 
asynchronous (ASTs), DRV 1.5, EXE 2.3, 

INT 3.3 
synchronous (SSTs), DRV 1.5, EXE 2.3, 
INT 3.3 



Table-driven parser, see TPARS 
Tape devices, 

multivolume operations with BRU, 
UTL 10.5 
Tapes, 

DECtape, see DECtape 

magnetic, see Magnetic tapes 
Task, 

interaction with error logging, ERL 2.2 

I/O operation, INT 6.3 
Task Builder, see also TKB 

use of, with PAT, UTL 18.2 
Task dumps, 

post mortem, INT 5.5, TKB 8.1 

snapshot, INT 5.5, TKB 8.2 
Task image, 

building, BEG 2.3 

file, structure of, TKB B 

memory allocation (map) file, BEG 2.3 

options, BEG 2.3 

running a, BEG 2.4 

switches, BEG 2.3 
Task/Image File Patch Program, see ZAP 
Task names, 

convention for, MCR 4.2 

references to in MCR, MCR 5.7 
Tasks, MCR 1.1 

building, INT 5.3, TKB 3.1 

checkpointing, INT 3.2 

creating, MCR 1 .4 

debugging, /ATT* 5.5 

executing, INT 5.4, MCfl 1.4 
external scheduling for, INT 4.1 

installing, MCR 1.4 

install-run-remove, MCR 4.2 

linking, TifB 3.1 

MCR command interface and, MCR 4.2 

multiuser, TKB 3.2 

naming convention for, MCR 4.2 

priority of, INT 3.2 

privileged, £;X£; 3.6, TKB 3.5 

scheduling, 
external, INT 4.1 
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Tasks, scheduling (Cont.), 

round robin, INT 3.2 

swapping, INT 3.2 
state of, INT 3.2 

user-written, spooling from, UTL 6.5 
Terminals, 
attached, INT 4.2, MCR 2.1 
characteristics of, MCR 2.1 
control characters on, BEG 1.1, MCR 2.1 
drivers for, 

full-duplex, £)i? 7 2 

half-duplex, DEV' 3 

virtual, Z)i?V^ 4 
function keys on, BEG 1.1 
input prompts for, MCR 2.1 
keyboard on, BEG 1.1 
logging off, MCR 2.3 
logging on, MCR 2.3 
privilege for, MCR 2.1 
slave, /iVr 4.2, MCfl 2.1 
special character keys on, MCR 2.1 
unattached, MCR 2.1 

TKB, see also Task Builder, 
assigning addresses, 

on mapped systems, TKB 2.2 

on unmapped systems, TKB 2.2 
building and linking with, TKB 3.1 
command line, TKB 1.1 
data structures, 

building system, TKB 2.3 

overlay, TKB 4.3 
fast, TKB E 
functions, TKB 2 
global symbols, 

resolving, TKB 2.1, 4.2 
host system for, TKB 7 
improving performance of, TKB D 
memory dumps, 

post mortem, TKB 8.1 

snapshot, TKB 8.2 
program sections, 

allocation of, TKB 2.1, 4.2 

virtual, TKB 3.4 
object modules, 

linking, TKB 2.1 
overlay, 

building an, TKB 4.7 

data structures, TKB 4.3 

descriptor language, TKB 4.4 
summary of, TKB 4.8 

error handling, TKB 5.3 

loading methods, TKB 5.1, 5.2 



TKB, overlay (Cont.), 

programs, TKB 4.6 

structures, TKB 4.1 

tree, TKB 4.2 
multiple-tree structures, TKB 4.5 
reserved symbols, TKB C 
slow, TKB D.3 

symbol definition file, TKB 3.1 
target system for, TKB 7 
task image file structure, TKB B 
task relocation, TKB 2.4 
tasks, 

multiuser, TfCfi 3.2 

privileged, TKB 3.5 
TPARS 
parser program using, 

how to generate, lOP 7.5 
source programs and, lOP 7.1 
Transferring files, 
with BRU, UTL 10.4 
with DSC, UTL 11.8 
with FLX, UTL 5 
with PIP, UTL 4.2 
Traps, 
reports on unexpected, ERL 4.2 
systems, INT 3.3 

asynchronous (ASTs), DRV 1.5, i^Xi; 2.3 

synchronous (SSTs), DRV 1.5, EXE 2.3 



U 



UCB (Unit Control Block), 

and I/O drivers, WRT 2.3, 4.1 
UFD (User File Directory), BEG 3.2 

creating, with PIP, UTL 4.2 

in Files-11 file system, INT 6.2, MCR 3.1 
UIC (User Identification Code), MCR 3.2 
UMD (User-Mode Diagnostics), see Diagnos- 
tics, user mode 
Unibus switch driver, DRV 23 
Unit Control Block, see UCB 
Universal digital controller driver, DRV 15 
Unmapped systems, INT 3.1 
User File Directory, see UFD 
User Identification Code, see UIC 
User-Mode Diagnostics, see Diagnostics, 

user-mode 
User written drivers, see Drivers, I/O, 

user-written 
Utilities, 

command line format for, UTL 1.1 
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utilities (Cont.), 
editing, 

EDI, UTL 3 

EDT, UTL 2 
file manipulation, 

FLX, UTL 5 

PIP, UTL 4 
file specification format for, UTL 1.1 
file spooling, 

PRI and QUE, UTL 6 

Queue Manager, UTL 7 
indirect command files and, UTL 1.4 
invoking, UTL 1.4 
list of, UTL 1.1 
progiam maintenance, 

CMP, UTL 16 

PAT, UTL 18 

SLP, UTL 17 

ZAP, UTL 19 
programming, 

DMP, UTL 15 

LBR, UTL 14 
volume maintenance, 

BAD, UTL 9 

BRU, UTL 10 

DSC, i/TL 11 

FMT, UTL 8 

PRESRV. f/TL 12 

VFY, i/TL 13 



Virtual I/O, Die F 1.2 

Virtual Monitor Console Routine, see VMR 

VMR (Virtual Monitor Console Routine), 

GENS 
Volumes, 
backing up, with BRU, UTL 10.4 
deleting files from, with FLX, UTL 5.2 
directory listings of, with FLX, UTL 5.2 
formatting, 
with FLX, UTL 5.2 
with FMT, UTL 8.3 
initializing, with FLX, UTL 5.2 
preserving, with PRESRV, UTL 12 
transferring files between, with FLX, 
UTL 5.2 

w 

WDB (Window Definition Block), 
data structure, EXE 3.5 

Wildcards (asterisk), 
convention as file specifier, MCR 3.2 
in PIP file specifications, UTL 4.1 

Window Definition Block, see WDB 

X 

XDT (Executive Debugging Tool), 
and I/O drivers, WRT 3.4 



Verifying, 
contents of a task image file with ZAP, 

UTL 19.6 
file structures with VFY, UTL 13 
VFY (File Structure Verification Utility), 

UTL 13 
Virtual address space, EXE 3.1 



ZAP (Task/Image File Patch Program), 
UTL 19 
addressing locations in a task image with, 

UTL 19.3 
changing contents of a location with, 
UTL 19.5 
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